Ubuntu PHP环境变量如何配置

Ubuntu下PHP环境变量配置指南

在Ubuntu系统中，PHP环境变量的配置主要分为命令行（CLI）环境变量和PHP-FPM进程环境变量两部分，以下是详细步骤：

一、命令行（CLI）环境变量配置

命令行环境变量主要用于在终端中直接运行php命令，配置路径为用户的~/.bashrc文件（当前用户）或/etc/profile（全局用户）。

1. 安装PHP（若未安装）

使用Ubuntu默认包管理器apt安装PHP（以PHP 8.1为例）：

sudo apt update
sudo apt install php php-cli php-fpm php-mysql  # 安装PHP核心、CLI工具、FPM及MySQL扩展

2. 编辑环境变量文件

打开当前用户的~/.bashrc文件（若需全局配置，替换为sudo nano /etc/profile）：

nano ~/.bashrc

在文件末尾添加PHP可执行文件路径（Ubuntu中PHP默认安装在/usr/bin，可通过which php命令确认路径）：

export PATH=$PATH:/usr/bin  # 若PHP安装在非默认路径，替换为实际路径（如/usr/local/php/bin）

3. 使配置生效

保存文件后，运行以下命令使更改立即生效：

source ~/.bashrc  # 全局配置则用 source /etc/profile

4. 验证配置

运行以下命令检查PHP版本，若显示版本信息则说明配置成功：

php -v

二、PHP-FPM进程环境变量配置

PHP-FPM（FastCGI进程管理器）用于处理Web请求，其环境变量需通过php-fpm.conf或pool.d/www.conf文件配置，主要影响Web应用中的$_ENV变量读取。

1. 开启`$_ENV`变量读取

编辑PHP-FPM的主配置文件（路径随PHP版本变化，如PHP 8.1为/etc/php/8.1/fpm/php.ini），找到variables_order参数，将GPCS修改为EGPCS（追加E以启用$_ENV）：

sudo nano /etc/php/8.1/fpm/php.ini

修改前：

variables_order = "GPCS"

修改后：

variables_order = "EGPCS"

2. 配置PHP-FPM进程环境变量

编辑PHP-FPM的进程池配置文件（如/etc/php/8.1/fpm/pool.d/www.conf），找到clear_env参数并设置为no（允许传递环境变量），然后添加需要的环境变量（如PATH、MYSQL_HOME）：

sudo nano /etc/php/8.1/fpm/pool.d/www.conf

添加或修改以下内容：

clear_env = no  # 关闭环境变量清除（默认是yes，会清除子进程环境变量）
env[PATH] = /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin  # 设置PATH环境变量
env[MYSQL_HOME] = /usr  # 示例：添加MySQL环境变量

3. 重启PHP-FPM服务

修改配置后，重启PHP-FPM使更改生效：

sudo systemctl restart php8.1-fpm  # 替换为实际PHP版本（如php7.4-fpm）

4. 验证PHP-FPM环境变量

创建一个PHP测试文件（如/var/www/html/env_test.php），内容如下：

<?php
print_r($_ENV);
?>

通过浏览器访问http://localhost/env_test.php，若能看到包含PATH、MYSQL_HOME等环境变量的数组，则说明配置成功。

注意事项

路径确认：若PHP安装在非默认路径（如手动编译安装），需通过which php命令确认可执行文件路径，并替换配置中的路径。
权限问题：修改系统级配置文件（如/etc/profile、/etc/php/8.1/fpm/php.ini）需使用sudo权限。
Web服务器配置：若需通过Web访问PHP，还需配置Apache或Nginx以支持PHP（如Apache启用php8.1模块、Nginx配置fastcgi_pass指向PHP-FPM socket）。

通过以上步骤，可完成Ubuntu下PHP环境变量的配置，满足命令行和Web应用的需求。