全面覆盖Windows/Linux/macOS平台安装方案|Nginx/Apache集成|MySQL配置|Composer使用|常见报错解决方案|新手友好型实战指南
在Windows系统上部署PHP环境需明确以下关键点:
推荐采用VC15 x64 Non Thread Safe版本(适用于IIS+FastCGI或Nginx)
extension_dir = "ext"
extension=openssl
extension=curl
extension=mbstring
extension=gd
extension=pdo_mysql
date.timezone = Asia/Shanghai
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 512M
使用FastCGI模块集成PHP:
<?php phpinfo(); ?>,访问验证
不同Linux发行版的PHP包管理方式差异显著:
| 发行版 | 默认源版本 | 推荐安装方式 | 优势 |
|---|---|---|---|
| Ubuntu 22.04 | 8.1 | ondrej/php源 | 支持多版本并存,更新及时 |
| Debian 11 | 7.4 | deb.sury.org | 稳定可靠,社区支持强 |
| CentOS 8 | 7.2 | Remi仓库 | 企业级稳定性保障 |
| Alpine Linux | 8.2 | apk add php82 | 容器环境体积最小 |
# 添加Ondrej PHP源
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
# 安装PHP及常用扩展
sudo apt install php8.2 php8.2-cli php8.2-fpm \
php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring \
php8.2-xml php8.2-zip php8.2-bcmath php8.2-intl
# 验证版本
php -v
# 添加Remi仓库
sudo dnf install https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %rhel).rpm
sudo dnf module reset php
sudo dnf module enable php:remi-8.2
# 安装PHP
sudo dnf install php php-cli php-fpm php-mysqlnd \
php-gd php-mbstring php-xml php-zip php-bcmath \
php-intl php-opcache
# 启动服务
sudo systemctl enable --now php-fpm
# 安装编译依赖
sudo apt build-dep php8.2 # Ubuntu/Debian
sudo dnf builddep php # CentOS/RHEL
# 下载源码
wget https://www.php.net/distributions/php-8.2.10.tar.xz
tar -xf php-8.2.10.tar.xz
cd php-8.2.10
# 配置编译选项
./configure --prefix=/usr/local/php \
--with-config-file-path=/etc/php \
--enable-fpm --with-fpm-user=www-data \
--with-mysqli --with-pdo-mysql \
--with-curl --with-gd --with-openssl \
--with-zip --with-zlib --with-xmlrpc \
--enable-mbstring --enable-intl
# 编译安装
make -j$(nproc)
sudo make install
# 复制配置文件
sudo cp php.ini-production /etc/php/php.ini
编辑php.ini后需重点调整以下参数:
| 参数 | 推荐值 | 说明 |
|---|---|---|
| opcache.enable | 1 | 启用OPcache字节码缓存 |
| opcache.memory_consumption | 256 | OPcache内存大小(MB) |
| opcache.interned_strings_buffer | 64 | 字符串缓存大小(MB) |
| max_execution_time | 30 | 脚本最大执行时间(秒) |
| max_input_vars | 5000 | POST/GET变量上限 |
| realpath_cache_size | 4096K | 文件路径缓存大小 |
macOS从12 Monterey起移除内置PHP,需自行安装:
# 安装Homebrew(若未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 添加PHP仓库
brew tap shivammathur/php
# 安装PHP 8.2
brew install shivammathur/php/php@8.2
# 验证安装
php -v
# 输出示例:PHP 8.2.10 (cli) (built: Sep 5 2023 10:30:15)
# 启动服务
brew services start shivammathur/php/php@8.2
# 设置PATH优先级
echo 'export PATH="/opt/homebrew/opt/php@8.2/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 安装Nginx(通过Homebrew)
brew install nginx
# 启动Nginx
sudo brew services start nginx
# 配置Nginx支持PHP
sudo nano /opt/homebrew/etc/nginx/nginx.conf
添加server块中的关键配置:
location ~ \.php$ {
root /Users/yourname/Sites;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
# 安装Nginx与PHP-FPM
sudo apt install nginx php-fpm
# 创建虚拟主机配置
sudo nano /etc/nginx/sites-available/php-site
配置内容:
server {
listen 80;
server_name dev.example.com;
root /var/www/html;
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 ~ /\.htaccess {
deny all;
}
}
sudo nginx -t → 无错误后重启服务:sudo systemctl restart nginx php8.2-fpm
# 安装Nginx与PHP-FPM
brew install nginx php
# 配置Nginx
sudo nano /opt/homebrew/etc/nginx/nginx.conf
关键server块配置:
server {
listen 8080;
server_name localhost;
root /Users/yourname/Sites;
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;
}
}
server {
listen 80;
server_name localhost;
root c:/nginx/html;
location / {
index index.php index.html;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9123;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
| 配置项 | 位置 | 推荐值 |
|---|---|---|
| worker_processes | nginx.conf主配置 | auto |
| worker_connections | events块 | 1024 |
| fastcgi_buffers | server块 | 16 16k |
| fastcgi_buffer_size | server块 | 32k |
| pm.max_children | php-fpm.conf | 根据内存计算:内存(MB)/30 |
# Ubuntu/Debian
sudo apt install libapache2-mod-php8.2
# CentOS/RHEL
sudo dnf install php php-cli php-fpm php-mysqlnd
# 验证模块加载
apache2ctl -M | grep php
配置文件位置:
sudo systemctl restart apache2(Ubuntu)sudo systemctl restart httpd(CentOS)
# 安装PHP-FPM
sudo apt install php8.2-fpm
# 配置Apache代理
sudo a2enmod proxy_fcgi setenvif
sudo a2enconf php8.2-fpm
# 创建虚拟主机配置
sudo nano /etc/apache2/sites-available/php-fpm.conf
配置内容:
<VirtualHost *:80>
ServerName php-fpm.local
DocumentRoot /var/www/html
<FilesMatch \.php$>
SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost/"
</FilesMatch>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
sudo a2ensite php-fpm.confsudo systemctl restart apache2
<VirtualHost *:80>
ServerName dev.example.com
DocumentRoot /var/www/dev.example.com/public
<Directory /var/www/dev.example.com/public>
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
<FilesMatch \.php$>
SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost/"
</FilesMatch>
</Directory>
ErrorLog ${APACHE_LOG_DIR}/dev-error.log
CustomLog ${APACHE_LOG_DIR}/dev-access.log combined
</VirtualHost>
| 扩展 | 适用PHP版本 | 特点 | 推荐场景 |
|---|---|---|---|
| mysqli | PHP 4+ | 面向过程/对象双接口,支持预处理 | 传统项目迁移 |
| PDO_MySQL | PHP 5+ | 统一接口,支持多数据库 | 现代框架(Laravel/Symfony) |
| mysqlnd | PHP 5.3+ | 原生驱动,性能优化 | 所有新项目 |
<?php
// PDO连接示例
$dsn = 'mysql:host=localhost;dbname=test;charset=utf8mb4';
$username = 'root';
$password = 'your_password';
try {
$pdo = new PDO($dsn, $username, $password, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8mb4'
]);
echo '连接成功!数据库版本:' . $pdo->getAttribute(PDO::ATTR_SERVER_VERSION);
} catch (PDOException $e) {
die('连接失败:' . $e->getMessage());
}
// mysqli连接示例
$mysqli = new mysqli('localhost', 'root', 'your_password', 'test');
if ($mysqli->connect_error) {
die('连接失败:' . $mysqli->connect_error);
}
echo '连接成功!MySQL版本:' . $mysqli->server_info;
?>
mysql.default_charset = "utf8mb4"[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
# Linux/macOS
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0f71295b675a8c075c377548c655d186c05d226a45ad0a75a196c744d2567e9325e56') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer
# Windows(推荐使用安装程序)
# 下载:https://getcomposer.org/Composer-Setup.exe
| 命令 | 功能 | 示例 |
|---|---|---|
| composer init | 初始化项目 | 创建composer.json配置 |
| composer require | 添加依赖 | composer require monolog/monolog |
| composer update | 更新依赖 | 根据composer.json更新包 |
| composer dump-autoload | 生成自动加载 | 优化PSR-4加载路径 |
| composer show | 列出已安装包 | composer show -i列出所有依赖 |
composer require --dev security-checker/security-checkerphp security-checker security:check composer.lock
{
"name": "vendor/project",
"description": "PHP项目模板",
"type": "project",
"require": {
"php": "^8.2",
"monolog/monolog": "^3.0",
"guzzlehttp/guzzle": "^7.5"
},
"require-dev": {
"phpunit/phpunit": "^10.0",
"friendsofphp/php-cs-fixer": "^3.14"
},
"autoload": {
"psr-4": {
"App\\": "src/"
}
},
"config": {
"allow-plugins": {
"php-http/discovery": true
}
}
}
| 错误代码 | 错误信息 | 原因分析 | 解决方案 |
|---|---|---|---|
| 500 | Internal Server Error | PHP语法错误或扩展缺失 | 检查error_log,启用display_errors |
| 502 | Bad Gateway | PHP-FPM进程崩溃 | 重启php-fpm,检查进程数限制 |
| 503 | Service Unavailable | 资源耗尽(内存/CPU) | 增加memory_limit,优化脚本 |
| 404 | Not Found | URL重写配置错误 | 检查Nginx/Apache重写规则 |
| 403 | Forbidden | 目录权限不足 | 调整文件权限(755/644) |
// php.ini
display_errors = On
error_reporting = E_ALL
<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);
echo "PHP版本:" . phpversion() . "<br>";
echo "配置文件:" . php_ini_loaded_file() . "<br>";
$extensions = get_loaded_extensions();
sort($extensions);
echo "已加载扩展:" . implode(", ", $extensions) . "<br>";
echo "当前用户:" . get_current_user() . "<br>";
echo "文档根目录:" . $_SERVER['DOCUMENT_ROOT'] . "<br>";
?>
Fatal error: Allowed memory size of 134217728 bytes exhausted
解决方案:
ini_set('memory_limit', '512M');| 配置项 | 推荐值 | 安全作用 |
|---|---|---|
| expose_php | Off | 隐藏PHP版本信息 |
| display_errors | Off | 生产环境禁止显示错误 |
| allow_url_fopen | Off | 防止远程文件包含 |
| allow_url_include | Off | 禁止远程文件包含攻击 |
| open_basedir | /var/www | 限制文件访问范围 |
$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
if ($email === false) {
die('无效邮箱格式');
}
// HTML上下文
echo htmlspecialchars($data, ENT_QUOTES, 'UTF-8');
// SQL上下文(使用预处理)
$stmt = $pdo->prepare('SELECT * FROM users WHERE email = ?');
$stmt->execute([$email]);
<?php
if ($_FILES['upload']['error'] === UPLOAD_ERR_OK) {
$file = $_FILES['upload'];
// 1. 检查MIME类型
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $file['tmp_name']);
finfo_close($finfo);
$allowed = ['image/jpeg', 'image/png', 'image/gif'];
if (!in_array($mime, $allowed)) {
die('不允许的文件类型');
}
// 2. 重命名文件(禁止原始文件名)
$ext = pathinfo($file['name'], PATHINFO_EXTENSION);
$newName = uniqid('upload_', true) . '.' . $ext;
// 3. 保存到非Web目录
$uploadDir = '/var/www/uploads/';
$targetPath = $uploadDir . $newName;
if (move_uploaded_file($file['tmp_name'], $targetPath)) {
echo '上传成功:' . $newName;
} else {
die('上传失败');
}
}
?>
| 版本 | 发布日期 | 安全支持截止 | 推荐指数 | 主要特性 |
|---|---|---|---|---|
| 7.4 | 2019-11-28 | 2022-11-28 | ★★★☆☆ | 预加载、弱类型改进 |
| 8.0 | 2020-11-26 | 2023-11-26 | ★★★★☆ | JIT编译、联合类型 |
| 8.1 | 2021-11-25 | 2024-11-25 | ★★★★★ | 枚举、readonly属性 |
| 8.2 | 2022-12-08 | 2025-12-08 | ★★★★★ | 类常量可见性、null类型 |
# 列出所有已安装扩展
php -m | grep -v '^$' | sort
# 检查扩展是否支持新版本
php -r "echo extension_loaded('mbstring') ? 'OK' : 'MISSING';"
<?php
// 1. 枚举(Enums)
enum Status: string
{
case Active = 'active';
case Inactive = 'inactive';
case Pending = 'pending';
}
// 2. 只读属性(readonly)
class User {
public readonly string $name;
public function __construct(string $name) {
$this->name = $name;
}
}
// 3. 类常量可见性
class Config {
private const API_KEY = 'secret';
protected const DB_HOST = 'localhost';
public const VERSION = '1.0';
}
// 4. 纯值类型(null类型)
function process(?string $data): void {
if ($data === null) {
throw new InvalidArgumentException('Data cannot be null');
}
echo strlen($data);
}
// 5. 随机数改进
$random = random_int(1, 100);
$uuid = bin2hex(random_bytes(16));
?>