Linux下PHP开发环境搭建需依次完成:一、用apt/dnf安装PHP及扩展并验证;二、修改php.ini配置错误报告、时区等参数;三、Nginx+PHP-FPM或四、Apache+mod_php集成;五、安装Composer管理依赖。
如果您在 Linux 系统上需要运行 PHP 应用程序,但系统尚未安装 PHP 或相关运行环境,则可能是由于 PHP 解释器、Web 服务器及扩展模块均未配置。以下是完成 Linux 下 PHP 开发环境搭建的具体步骤:
一、使用包管理器安装 PHP 及核心扩展
大多数主流 Linux 发行版提供预编译的 PHP 包,通过系统原生包管理器可快速部署稳定版本,并自动处理依赖关系。
1、对于 Ubuntu/Debian 系统,执行以下命令更新软件源并安装 PHP 及常用扩展:sudo apt update && sudo apt install php php-cli php-mysql php-curl php-gd php-mbstring php-xml php-zip -y立即学习“PHP免费学习笔记(深入)
”;
2、对于 CentOS/RHEL/Rocky Linux 8+ 系统,启用 EPEL 和 PowerTools 仓库后安装:sudo dnf install epel-release -y && sudo dnf config-manager --set-enabled powertools && sudo dnf install php php-cli php-mysqlnd php-curl php-gd php-mbstring php-xml php-zip -y
3、验证安装结果:
php -v
4、检查已加载模块:
php -m | grep -E "(mysql|curl|gd|mbstring)"
二、配置 PHP 运行参数(修改 php.ini)
PHP 的行为由 php.ini 配置文件控制,调整关键参数可满足开发调试需求,例如错误报告级别、时区、上传限制等。
1、定位当前生效的 php.ini 文件路径:php --ini | grep "Loaded Configuration File"
2、备份原始配置文件:
sudo cp /etc/php/*/cli/php.ini /etc/php/*/cli/php.ini.bak 3、编辑 php.ini 文件,修改以下关键项:error_reporting = E_ALL display_errors = On date.timezone =Asia/Shanghai upload_max_filesize =64M post_max_size =64M 4、重启 PHP-FPM(如已安装)或重新加载 Web 服务器以使配置生效:sudo systemctl restart php-fpm
三、集成 Web 服务器:Nginx + PHP-FPM
Nginx 本身不解析 PHP,需通过 FastCGI 协议将请求转发给 PHP-FPM 进程管理器,该组合轻量高效,适合本地开发与生产环境。
1、安装 Nginx 和 PHP-FPM:Ubuntu/Debian:sudo apt install nginx php-fpm CentOS/RHEL:sudo dnf install nginx php-fpm 2、确认 PHP-FPM 服务已启用并运行:sudo systemctl enable php-fpm && sudo systemctl start php-fpm 3、编辑 Nginx 默认站点配置(/etc/nginx/sites-available/default 或 /etc/nginx/conf.d/default.conf),在 server 块内添加 location ~ \.php$ 块:location ~ \.php$ {include snippets/fastcgi-php.conf;fastcgi_pass unix:/var/run/php/php version-fpm.sock;}
4、替换
php_version为实际版本号(如 8.1),可通过 ls /var/run/php/ 查看可用 sock 文件名。
5、测试配置并重载 Nginx:sudo nginx -t && sudo systemctl reload nginx
四、集成 Web 服务器:Apache + mod_php
Apache 使用 mod_php 模块直接嵌入 PHP 解释器,配置简单,适合初学者快速启动开发环境,无需额外进程管理。
1、安装 Apache 与 PHP 模块:Ubuntu/Debian:sudo apt install apache2 libapache2-mod-php CentOS/RHEL:sudo dnf install httpd php 2、确保 mod_php 已启用:Ubuntu/Debian:sudo a2enmod php version CentOS/RHEL:模块通常随 php 包自动加载,无需手动启用。
3、创建测试文件验证 PHP 解析:echo "" | sudo tee /var/www/html/info.php 4、设置 Apache 监听端口并启动服务:sudo systemctl enable apache2 && sudo systemctl start apache2(Ubuntu)
sudo systemctl enable httpd && sudo systemctl start httpd(CentOS)
5、访问 http://localhost/info.php,页面应显示 PHP 配置信息,其中Server API显示为 Apache 2.0 Handler 表示集成成功。
五、安装 Composer 并初始化项目
Composer 是 PHP 的依赖管理工具,用于安装 Laravel、Symfony 等框架及第三方库,是现代 PHP 开发的标准组件。
1、下载 Composer 安装脚本:php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"2、校验安装脚本 SHA384 哈希值(以官方最新发布为准,此处为示例值):EXPECTED_CHECKSUM="$(wget -q -O - https://composer.github.io/installer.sig)"php -r "if (hash_file('sha384', 'composer-setup.php') !== '$EXPECTED_CHECKSUM') { unlink('composer-setup.php'); echo 'Integrity check failed'; exit(1); } else { echo 'Integrity check passed'; }"
3、执行安装并全局移动至系统路径:
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
4、验证安装:
composer --version
5、在项目目录中初始化新项目:
composer create-project laravel/laravel myapp 6、启动内置开发服务器(适用于 Laravel 等支持的框架):cd myapp && php artisan serve --host=0.0.0.0:8000
