PHP作为全球最广泛使用的服务端脚本语言之一,支撑着全球超77%的网站(数据来源:W3Techs)。从WordPress、Drupal等CMS系统,到Laravel、Symfony等现代框架,再到Discuz、WordPress等开源项目,其生态繁荣稳定。然而,对初学者而言,配置一个稳定、安全、可扩展的PHP运行环境仍存在诸多挑战——版本冲突、扩展缺失、权限错误、路径混乱、性能低下等问题频发。
本文以实战导向为核心,系统梳理PHP环境搭建的全链路知识体系,覆盖Windows/macOS/Linux三大主流平台及Docker容器化部署方案,深入剖析Nginx+PHP-FPM组合机制,详解常见扩展安装与调试工具链,并提供企业级安全加固策略。全文超4200字,结构清晰,示例详实,适配开发者、运维人员及技术爱好者多维需求。
环境搭建本质是软件依赖管理与系统权限配置的结合体,需兼顾:
⚡ 版本兼容性(PHP 7.4与8.3语法差异、扩展依赖)
⚙️ 运行时上下文(CGI/FastCGI/CLI模式区别)
🔒 安全边界控制(open_basedir、disable_functions、SELinux)
📈 性能可扩展性(OPcache、JIT编译、连接池)
🛠 开发调试友好度(Xdebug、Tracy、Blackfire)
截至2025年,PHP官方支持的版本为:
• PHP 8.3(活跃支持至2026年12月)
• PHP 8.2(活跃支持至2025年12月)
• PHP 8.1(活跃支持至2024年11月,已进入安全支持期)
• PHP 8.0(已终止支持)
• PHP 7.4(已终止支持)
⚠️ 重要提醒:终止支持版本存在未修复的高危漏洞(如CVE-2022-31629),严禁用于生产环境!
| 特性 | PHP 7.4 | PHP 8.0 | PHP 8.1 | PHP 8.2 | PHP 8.3 |
|---|---|---|---|---|---|
| 联合类型语法 | ❌ | ✅ int|string |
✅ | ✅ | ✅ |
| readonly 属性 | ❌ | ❌ | ✅ | ✅ | ✅ |
| JIT 编译器 | ❌ | ✅(仅CLI) | ✅(支持Web) | ✅(优化) | ✅(默认启用) |
| new \DateTime() 必须参数 | ⚠️ 警告 | ✅ 强制 | ✅ | ✅ | ✅ |
| 弃用特性 | 部分 | 47项 | 23项 | 12项 | 5项 |
💡 实践建议:使用 composer show php 检查项目最低要求版本;在 composer.json 中设置 "platform": {"php": "8.2"} 保证开发/生产一致性。
XAMPP是ApacheFriends推出的集成环境,包含Apache、MySQL、PHP、phpMyAdmin等组件,安装即用,适合教学与本地开发。
http://localhost → 应显示 XAMPP 欢迎页C:\xampp\htdocs\info.php:
<?php
phpinfo();
访问 http://localhost/info.php 查看PHP信息页Listen 8080 → 重启Apachephp.ini 中添加 default_charset = "UTF-8"pdo_mysql → 取消 php.ini 中 ;extension=pdo_mysql 前的分号 → 重启ApacheLaragon采用轻量级架构,支持一键切换PHP版本、自动虚拟主机管理、内置Composer、支持WSL2,是开发者推荐方案。
php -S localhost:8000 -c php.ini 切换版本www/ 目录创建文件夹 mysite → 自动映射 http://mysite.testC:\laragon(避免空格路径)laragon.exe → 首次启动自动初始化C:\laragon\www 创建 test 文件夹 → 访问 http://test.test编辑 C:\laragon\etc\laragon\laragon.ini:
[php]
version=8.2
保存后重启Laragon即可生效。
WAMPServer适合需要更精细控制的场景(如自定义Apache模块),但配置复杂度较高。
macOS系统自带PHP 7.x,但版本老旧且无法更新。推荐使用Homebrew管理现代PHP环境。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install php@8.2
brew link php@8.2 --force --overwrite
php -v
# 应输出 PHP 8.2.x (cli)
brew install nginx
1. 创建站点目录:
mkdir -p ~/Sites/test
echo '<?php echo "Hello PHP";' > ~/Sites/test/index.php
2. 编辑Nginx配置 /opt/homebrew/etc/nginx/nginx.conf:
server {
listen 8080;
server_name localhost;
root ~/Sites/test;
location / {
index index.php index.html;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
3. 启动服务:
sudo nginx # 如需80端口需管理员权限
php-fpm
4. 访问 http://localhost:8080 应显示 Hello PHP
chmod -R 755 ~/Sites/testps aux | grep php-fpmphp.ini 中设置 default_charset = "UTF-8"sudo apt update
sudo apt install apache2 php libapache2-mod-php php-mysql
sudo systemctl restart apache2
echo '<?php phpinfo();' | sudo tee /var/www/html/info.php
访问 http://localhost/info.phpsudo apt install nginx php-fpm8.2
创建配置文件 /etc/nginx/sites-available/myapp:
server {
listen 80;
server_name myapp.local;
root /var/www/myapp;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
location ~ /\.ht {
deny all;
}
}
启用站点:
sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
/etc/php/8.2/fpm/php.ini:
[opcache]
opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.validate_timestamps=1
opcache.revalidate_freq=60
/etc/php/8.2/fpm/pool.d/www.conf:
[www]
pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 20
--cpus、--memory 限制资源创建 docker-compose.yml:
version: '3.8'
services:
app:
image: php:8.2-fpm
container_name: php-app
volumes:
- ./src:/var/www/html
working_dir: /var/www/html
environment:
- PHP_INI_SCAN_DIR=:/usr/local/etc/php/conf.d:/etc/php/conf.d
web:
image: nginx:alpine
container_name: nginx-web
ports:
- "8080:80"
volumes:
- ./src:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf
depends_on:
- app
db:
image: mysql:8.0
container_name: mysql-db
environment:
MYSQL_ROOT_PASSWORD: root123
MYSQL_DATABASE: testdb
MYSQL_USER: user
MYSQL_PASSWORD: pass123
ports:
- "3306:3306"
创建 nginx.conf:
server {
listen 80;
server_name localhost;
root /var/www/html;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass app:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
docker-compose up -d
docker-compose exec app php index.php
docker-compose logs -f web
创建自定义Dockerfile:
FROM php:8.2-fpm
RUN apt-get update && apt-get install -y \
libpng-dev libjpeg-dev libfreetype6-dev \
&& docker-php-ext-configure gd --with-freetype --with-jpeg \
&& docker-php-ext-install gd mysqli pdo_mysql opcache
COPY php.ini /usr/local/etc/php/conf.d/custom.ini
在 docker-compose.yml 中使用:
build: .
container_name: php-custom
在 nginx.conf 中添加全局安全头:
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self'; frame-ancestors 'self';" always;
静态资源缓存配置:
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
| 参数 | 推荐值 | 说明 |
|---|---|---|
pm |
dynamic |
动态进程管理(生产) |
pm.max_children |
CPU核心数 × 2 |
最大子进程数 |
request_terminate_timeout |
30 |
单请求超时(秒) |
request_slowlog_timeout |
5 |
慢日志阈值 |
慢日志配置示例:
slowlog = /var/log/php-fpm/slow.log
request_slowlog_timeout = 5
在 php.ini 中添加:
[xdebug]
zend_extension=xdebug
xdebug.mode=debug,profile
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=trigger
xdebug.log_level=0
VS Code调试配置(.vscode/launch.json):
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"pathMappings": {
"/var/www/html": "${workspaceFolder}"
}
}
]
}
display_errors=On,生产环境关闭error_log("Debug: " . var_export($data, true)) 记录关键变量assert($value > 0)echo "Rendered in " . (microtime(true) - START_TIME) . "s"编辑 /etc/php/8.2/fpm/php.ini:
disable_functions = exec,passthru,system,shell_exec,proc_open,popen,curl_exec,curl_multi_exec,parse_ini_file,show_source
open_basedir = /var/www/html:/tmp
register_globals = Off
expose_php = Off
生产环境建议权限设置:
755644600(仅属主可读写)750(禁止执行权限)设置命令示例:
chown -R www-data:www-data /var/www/html
find /var/www/html -type d -exec chmod 755 {} \;
find /var/www/html -type f -exec chmod 644 {} \;
chmod 600 /var/www/html/config/*.php
Nginx中添加:
if ($scheme != "https") {
return 301 https://$host$request_uri;
}
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
500 Internal Server Error |
PHP语法错误/扩展缺失 | 检查 /var/log/apache2/error.log 或 /var/log/php-fpm.log |
403 Forbidden |
文件权限/SELinux限制 | 运行 setenforce 0 临时禁用SELinux测试 |
404 Not Found |
URL重写未启用 | 确认Nginx配置中 try_files 正确 |
502 Bad Gateway |
PHP-FPM崩溃 | 检查 ps aux | grep php-fpm,查看错误日志 |
Class 'PDO' not found |
pdo扩展未安装 | Ubuntu: apt install php-pdo-mysql |
Allowed memory size exhausted |
内存限制过低 | 在 php.ini 中设置 memory_limit = 512M |
php -i | grep "Configuration File"php -m | grep mysqliphp -r "var_dump(extension_loaded('pdo_mysql'));"tail -f /var/log/nginx/error.log在 php.ini 中添加:
[opcache]
opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.validate_timestamps=1
opcache.revalidate_freq=60
重启服务后生效。可通过 phpinfo() 查看是否启用。
| 特性 | PHP-CGI | PHP-FPM |
|---|---|---|
| 进程管理 | 静态,无自动重启 | 动态/静态,支持平滑重启 |
| 性能 | 低(每次请求启动新进程) | 高(常驻内存) |
| 资源消耗 | 高 | 低 |
| 适用场景 | 低流量/测试 | 生产环境 |
常见原因:
• BOM头(UTF-8 with BOM)→ 保存为 UTF-8 without BOM
• 输出前有空格/换行 → 确保 <?php 前无任何字符
• 使用 ob_start() 开启输出缓冲
• 检查 auto_prepend_file 是否输出内容
function process(string|int $data): void {
if (is_string($data)) {
echo "String: " . $data;
} else {
echo "Int: " . $data;
}
}
process("hello"); // OK
process(123); // OK
process(1.5); // TypeError
xdebug.profiler_enable=1memory_get_usage(true) 分段监控/etc/php/8.2/cli/php.ini,Web使用 /etc/php/8.2/fpm/php.iniE_ALL & ~E_DEPRECATEDgetcwd() 是脚本所在目录在 php.ini 中:
date.timezone = Asia/Shanghai
或在脚本中:
date_default_timezone_set("Asia/Shanghai");
使用 composer why-not phpunit/phpunit:^10 查看冲突原因
推荐策略:
1. 更新composer.json的 minimum-stability
2. 使用 composer update --with-all-dependencies
3. 手动锁定版本: composer require phpunit/phpunit:10.0.0 --no-update
class User {
public readonly string $name;
public function __construct(string $name) {
$this->name = $name;
}
}
$user = new User("Alice");
echo $user->name; // Alice
$user->name = "Bob"; // Error: Cannot modify readonly property User::$name
• 自动禁止修改https://github.com/php/pecl-file_formats-yaml)phpize
./configure
make
sudo make install
php.ini 中添加:extension=yaml.so
php -m | grep yaml# 保存镜像
docker commit php-app my-php:8.2-backup
# 导出容器
docker export php-app > php-app-backup.tar
# 保存数据卷
tar -czf db-backup.tar.gz /var/lib/mysql
tar -czf php-config-backup.tar.gz /etc/php/8.2/find /usr/lib/php/20220829 -name "*.so" > ext-list.txt/etc/nginx/sites-available/当前(2025年)PHP 8.4处于开发阶段,主要特性包括:
• Typed Properties 2.0:支持默认值与初始化表达式
• Match Expression 2.0:更简洁的模式匹配
• Property hooks:支持属性getter/setter
• Parameter promotion:构造函数参数直接声明属性
• Native async functions:原生异步支持(实验性)
phpstan 静态分析declare(strict_types=1) 严格模式php-cs-fixer 统一代码风格事实:2024年PHP仍占网站使用率第一(W3Techs),WordPress等CMS持续更新,Laravel框架活跃度全球前三。
事实:新版本需验证兼容性。例如:
• json_decode() 在PHP 8.3中对空字符串返回 null(7.x返回空数组)
• 弃用的函数如 each() 在8.0中已移除
事实:现代Docker(2024+)性能接近原生,尤其在macOS/Windows上通过WSL2提升显著。Linux原生部署时,Docker性能损耗约1-3%。
使用Docker Compose部署:
• PHP 7.4 → 测试旧CMS
• PHP 8.1 → 开发新项目
• PHP 8.3 → 尝鲜JIT性能
使用GitHub Actions自动测试:
```yaml
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
php: ['7.4', '8.1', '8.2', '8.3']
steps:
- uses: actions/checkout@v4
- uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php }}
- run: composer install
- run: phpunit
```
集成:
• Blackfire Agent → 收集数据
• Grafana → 可视化
• Prometheus → 存储指标
实时监控:
• 请求响应时间
• 内存峰值
• 数据库查询次数
• 错误率趋势
PHP环境搭建远不止“安装软件”那么简单,它涉及系统底层原理、网络协议、安全策略、运维规范等多维度知识。本文从版本选型、平台部署、容器化、性能优化、安全加固到故障排查,构建了完整的知识体系。
记住三个核心原则:
⚡ 一致性:开发/测试/生产环境尽可能一致
⚙️ 可复现性:任何操作应有文档/脚本记录
🔒 最小权限:服务仅需最低必要权限
持续学习官方文档、关注PHP社区动态(如PHP Weekly)、参与开源项目,是保持技术竞争力的关键。祝您搭建顺利!
| 版本 | 基准分数 | 内存占用 | JIT效果 |
|---|---|---|---|
| PHP 7.4 | 100 | 42MB | 无 |
| PHP 8.0 | 118 | 45MB | CLI提升15% |
| PHP 8.1 | 122 | 46MB | Web提升12% |
| PHP 8.2 | 126 | 44MB | 内存优化10% |
| PHP 8.3 | 130 | 43MB | 默认启用,JIT 2.0 |
注:测试环境 Intel Core i7-12700K, 32GB RAM, Ubuntu 22.04
function process(int|string $data)public readonly string $namepublic function __construct(public string $name)return match($status) { 200 => 'OK', default => 'ERROR' };public string $email { get { return $this->email; } set { $this->validateEmail($value); $this->email = $value; } }1. 修改默认端口避免冲突:
• 编辑 C:\xampp\apache\conf\httpd.conf:
Listen 8080 → ServerName localhost:8080
2. 启用SSL(HTTPS):
• 取消 C:\xampp\apache\conf\httpd.conf 中 #Include conf/extra/httpd-ssl.conf 注释
• 重启Apache → 访问 https://localhost
3. 配置全局PATH变量:
• 添加 C:\xampp\php 到系统PATH
• 可全局使用 php 命令
1. 自定义虚拟主机模板:
编辑 C:\laragon\etc\laragon\laragon.ini:
[apache]
document_root=C:\laragon\www
server_name=%s.test
2. 一键启用Composer:
在Laragon终端中执行:
laragon install composer
3. 集成WSL2开发:
• 安装Ubuntu from Microsoft Store
• 在Laragon设置中启用WSL2
• 访问 http://localhost:8080 → 自动转发到WSL2
php.ini 中添加:default_charset = "UTF-8"mbstring.http_input = UTF-8mbstring.http_output = UTF-8httpd -t 检查配置语法netstat -ano | findstr :80 查找占用进程C:\xampp\php\php.ini 中:extension=gd 是否启用Homebrew将软件安装在 /opt/homebrew/Cellar/,通过符号链接链接到 /usr/local/bin。
例如PHP安装后:
/opt/homebrew/Cellar/php@8.2/8.2.10/bin/php
→ 链接到 /opt/homebrew/bin/php
1. 创建站点配置:
sudo nano /opt/homebrew/etc/nginx/servers/test.local.conf
2. 配置内容:
server {
listen 80;
server_name test.local;
root /Users/$(whoami)/Sites/test;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
3. 重启服务:
sudo nginx -s reload
php-fpm
/opt/homebrew/etc/php/8.2/php-fpm.d/www.conf:pm.max_children = 8(8GB内存建议值)opcache.enable=1opcache.memory_consumption=256client_body_buffer_size 16k;client_header_buffer_size 1k;1. 安装Nginx + PHP-FPM:
sudo apt install nginx php8.2-fpm php8.2-mysql php8.2-xml php8.2-mbstring php8.2-gd php8.2-opcache
2. 配置Nginx站点:
sudo nano /etc/nginx/sites-available/phpapp
3. 启用站点:
sudo ln -s /etc/nginx/sites-available/phpapp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
若SELinux启用导致403错误:
1. 检查状态:sestatus
2. 临时禁用:setenforce 0
3. 永久配置:
sudo setsebool -P httpd_can_network_connect 1
sudo chcon -R -t httpd_sys_rw_content_t /var/www/html/storage
| 参数 | 推荐值 | 说明 |
|---|---|---|
pm |
dynamic |
动态管理子进程 |
pm.max_children |
16 |
最大进程数(4GB内存服务器) |
pm.start_servers |
8 |
初始进程数 |
pm.min_spare_servers |
4 |
最小空闲进程 |
pm.max_spare_servers |
12 |
最大空闲进程 |
Dockerfile示例:
# 构建阶段
FROM php:8.2-cli AS builder
WORKDIR /app
COPY composer.json composer.lock ./
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer \
&& composer install --no-dev --optimize-autoloader
# 运行阶段
FROM php:8.2-fpm-alpine
WORKDIR /var/www/html
COPY --from=builder /app/vendor ./vendor
COPY . .
RUN apk add --no-cache oniguruma-dev \
&& docker-php-ext-install pdo_mysql \
&& chown -R www-data:www-data /var/www/html
EXPOSE 9000
CMD ["php-fpm"]
优势:
• 镜像体积减少50%+
• 安全攻击面减少
• 构建时间缩短30%
1. 创建自定义网络:
docker network create php-net
2. 运行容器并加入网络:
docker run --network php-net --name php-app php:8.2-fpm
3. 挂载开发目录:
-v $(pwd):/var/www/html
-v ./php.ini:/usr/local/etc/php/conf.d/custom.ini
docker exec -it php-app bashdocker logs -f php-app-v ./xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini-p 9003:9003(Xdebug调试端口)全局配置(/etc/nginx/nginx.conf):
http {
# 安全头
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
# CSP策略
add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self'; frame-ancestors 'self';" always;
# HSTS
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
# 其他配置...
}
注意:添加CSP后,需确保所有资源符合策略,否则会阻止加载。
静态资源缓存:
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf)$ {
expires 30d;
add_header Cache-Control "public, max-age=2592000, immutable";
}
动态内容禁用缓存:
location ~ \.php$ {
add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0";
add_header Pragma "no-cache";
add_header Expires "0";
# 其他配置...
}
1. 强制HTTPS:
if ($scheme != "https") {
return 301 https://$host$request_uri;
}
2. 防止目录遍历:
location ~ /\. {
deny all;
}
3. 防止脚本执行(上传目录):
location /uploads {
location ~ \.php$ {
return 403;
}
}
1. 安装扩展:
pecl install xdebug
2. 配置 php.ini:
[xdebug]
zend_extension=xdebug
xdebug.mode=debug,profile,develop
xdebug.client_host=host.docker.internal # Docker中使用
xdebug.client_port=9003
xdebug.start_with_request=trigger
xdebug.log=/tmp/xdebug.log
xdebug.trace_output_name=trace.%c.%p
3. IDE配置:
• VS Code:安装 PHP Debug 插件
• PhpStorm:设置 Preferences → PHP → Debug → 端口9003
1. 安装:
composer require nette/tracy
2. 使用示例:
use Tracy\Debugger;
Debugger::enable();
Debugger::barDump($data, '调试变量');
优势:
• 无需修改代码即可显示错误
• 变量转储美观
• SQL查询计时
• 内存使用监控
| 工具 | 类型 | 优点 | 缺点 |
|---|---|---|---|
| Xdebug Profiler | 免费 | 集成简单 | 输出文件大 |
| Blackfire | 商业 | 可视化强 | 需订阅 |
| Tideways | 混合 | 支持SaaS | 学习曲线陡 |
| Valgrind | 系统级 | 内存泄漏检测 | 性能影响大 |
编辑 /etc/php/8.2/fpm/php.ini:
expose_php = Off → 隐藏PHP版本disable_functions = exec,passthru,system,shell_exec → 禁用危险函数open_basedir = /var/www/html:/tmp → 限制文件访问session.cookie_httponly = 1 → 防XSS攻击session.use_strict_mode = 1 → 防会话固定session.cookie_secure = 1 → 仅HTTPS传输1. 验证MIME类型(非仅扩展名):
if (exif_imagetype($_FILES['upload']['tmp_name']) !== IMAGETYPE_JPEG) {
die("Invalid image type");
}
2. 重命名文件:
$filename = uniqid() . '.' . pathinfo($filename, PATHINFO_EXTENSION);
3. 存储到非Web目录:
move_uploaded_file($tmp, '/var/data/uploads/' . $filename);
4. 上传目录禁用执行:
在Nginx中:
location /uploads {
location ~ \.php$ { return 403; }
}
✅ 正确做法(预处理):
$stmt = $pdo->prepare('SELECT * FROM users WHERE email = :email');
$stmt->execute(['email' => $email]);
$user = $stmt->fetch();
❌ 错误做法(字符串拼接):
$sql = "SELECT * FROM users WHERE email = '$email'";
$result = $pdo->query($sql);
补充:
• 使用PDO而非mysqli
• 开启 PDO::ATTR_EMULATE_PREPARES = false
• 输入验证(filter_var)
诊断步骤:
1. 检查错误日志:
tail -f /var/log/nginx/error.log
tail -f /var/log/php-fpm.log
2. 临时启用错误显示:
在脚本开头添加:
ini_set('display_errors', 1);
error_reporting(E_ALL);
3. 检查文件权限:
ls -la /var/www/html
chown -R www-data:www-data /var/www/html
可能原因:
• PHP-FPM崩溃 → 重启:systemctl restart php8.2-fpm
• 连接池耗尽 → 增加 pm.max_children
• 超时设置过短 → 调整 request_terminate_timeout
验证方法:
ps aux | grep php-fpm
netstat -an | grep 9000
检查Nginx重写规则:
location / {
try_files $uri $uri/ /index.php?$query_string;
}
确认站点目录正确:
root /var/www/html;
检查文件存在性:
ls -l /var/www/html/index.php
| 扩展名 | Ubuntu安装命令 | 功能 |
|---|---|---|
| gd | apt install php8.2-gd |
图像处理 |
| intl | apt install php8.2-intl |
国际化支持 |
| zip | apt install php8.2-zip |
压缩文件 |
| redis | pecl install redis |
Redis客户端 |
| memcached | apt install php8.2-memcached |
Memcached客户端 |