PHP 安装完全指南 · 从零到生产
本指南覆盖 Windows、Linux 及 macOS 平台的 PHP 安装细节,并解答网友们还关心的〈版本差异〉、〈Composer 集成〉与〈性能调优〉等周边问题。
① Windows 快速安装
下载官方 PHP 线程安全版本,或使用 XAMPP 集成环境。配置 php.ini 扩展目录,注意 VC运行库 依赖。
php -v 验证安装。
② Linux 源码编译
通过 apt/ yum 安装或编译 PHP 8.2+。需安装 libxml、openssl 等依赖。网友们还关心 FPM 优化。
③ macOS 环境
使用 Homebrew 执行 brew install php,自动链接 pecl 扩展。注意 libicu 版本冲突。
〈 环境部署 〉分步详解
⚡ Windows 下 PHP 安装与配置
步骤一:访问 windows.php.net 下载 PHP 8.2 非线程安全版本(若使用IIS则选线程安全)。解压至 C:\php。
步骤二:复制 php.ini-development 并重命名为 php.ini。启用扩展:extension=mbstring、extension=openssl。
步骤三:将 C:\php 加入系统环境变量 Path。命令行输入 php -m 查看模块。
※ 常见问题:缺失 VCRUNTIME140.dll 需安装 Visual C++ Redistributable。
🐧 Ubuntu/Debian 安装 PHP
快速安装:sudo apt update && sudo apt install php8.1 php8.1-fpm php8.1-mysql
源码编译:下载 php.net 源码,配置 ./configure --prefix=/usr/local/php --enable-fpm。网友们还关心 opcache 启用。
安装后通过 systemctl start php8.1-fpm 启动服务。务必调整 www.conf 用户权限。
🍎 macOS 通过 Homebrew 安装
brew install php@8.2 自动处理依赖。随后 brew link php@8.2。配置文件位于 /opt/homebrew/etc/php/8.2/。
启用 php-fpm:brew services start php@8.2。搭配 nginx 使用时注意 fastcgi_pass 端口。
〈 配置调优 〉时间线
php.ini 核心参数
memory_limit = 256M ,max_execution_time = 60 ,display_errors = Off (生产环境)。调整 upload_max_filesize 影响附件上传。
OPcache 加速
启用 opcache.enable=1 ,设置 opcache.memory_consumption=128。网友们还关心 opcache.revalidate_freq 对代码更新影响。
Composer 安装与镜像
下载 composer.phar 并全局移动。使用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 加速。
〈 扩展管理 〉网友们还关心
◈ PDO 数据库扩展
php_pdo_mysql 与 php_pdo_pgsql 需在 php.ini 中启用。确认 extension_dir 路径正确。
◈ Redis 扩展安装
使用 pecl install redis 或编译 phpredis。在 php.ini 添加 extension=redis.so。
◈ Xdebug 调试器
pecl install xdebug 后配置 zend_extension。搭配 VS Code 或 PhpStorm 使用。
〈 高频问题 〉快速排查
☆ PHP 版本如何选择?
目前主流推荐 PHP 8.1 或 8.2,性能较7.x提升显著。旧项目若依赖 PHP 7.4 可继续使用,但需注意安全补丁。网友们还关心 PHP 8.3 新特性如 json_validate 函数。
选择依据:框架要求(Laravel 10 需要 PHP 8.1+)、扩展兼容性。建议本地开发环境与生产一致。
⚠️ 常见安装报错
“Unable to load dynamic library”:检查 extension_dir 路径及扩展文件是否存在。Windows 下注意 php_xxx.dll 是否匹配。
“Call to undefined function”:对应扩展未启用,如 mbstring、curl。在 php.ini 中取消注释并重启服务。
🔒 文件权限与 SELinux
Linux 下 session 目录不可写,需 chmod 733 /var/lib/php/sessions。若使用 SELinux,执行 setsebool -P httpd_execmem 1。
FPM 用户需与 nginx 用户一致,避免 Permission denied。
〈 周边工具 〉提升效率
📦 Composer 依赖
composer init 初始化项目,composer require 安装包。锁定 composer.lock 保证版本一致。
🧪 测试环境
使用 PHP内置服务器:php -S localhost:8000 快速预览。搭配 Xdebug 断点调试。
〈 深度配置 〉php.ini 详解
PHP 安装后的核心在于 php.ini 文件。该文件控制着错误报告、资源限制、扩展加载等。例如 error_reporting = E_ALL & ~E_DEPRECATED 可隐藏过时警告。设置 date.timezone = Asia/Shanghai 避免时区警告。对于文件上传,post_max_size 应大于 upload_max_filesize。启用 zlib.output_compression 可压缩输出。网友们还关心 session.gc_maxlifetime 调整会话有效期。在CLI模式下,php -i | grep php.ini 可定位配置文件路径。若使用 PHP-FPM,需单独调整 www.conf 中的 pm.max_children 防止内存溢出。许多开发者忽略 opcache.jit 配置,在PHP8中可设置 opcache.jit_buffer_size=100M 提升计算性能。务必确认 disable_functions 安全设置,例如禁用 exec、system 等危险函数。整个 PHP 安装 流程中,配置优化占据一半以上的稳定性因素。
※ 以上涵盖了从 PHP安装 到周边配置、扩展管理、常见排错的全链路知识。持续更新中。