在统信UOS系统部署PHP项目前，须先安装PHP运行环境（含php-mbstring、php-xml等关键扩展）和Composer，配置PHP-FPM为TCP监听并以非root用户运行，最后验证php -v与composer -V命令成功输出版本信息。
在统信UOS系统上部署PHP项目前，必须先装好PHP运行环境与Composer包管理器，否则执行php -v会提示命令未找到，运行composer create-project则直接报错“command not found”，所有依赖安装和框架初始化都将中断。
安装PHP运行环境（apt官方源方式）
该方式适用于UOS桌面专业版V20或服务器版V20，系统已预配置Debian兼容源，无需额外添加第三方仓库，安装后即可立即验证。
执行sudo apt update同步软件包索引，确保能获取到最新PHP元数据。
安装PHP核心及关键扩展：sudo apt install -y php php-fpm php-cli php-mysql php-curl php-gd php-mbstring php-xml php-zip php-bcmath php-opcache。
这一步必须包含【php-mbstring 和 php-xml】——Laravel、WordPress、ThinkPHP等主流框架启动时强制校验这两个扩展，缺一将导致composer install中途退出或首页白屏且无错误日志。
验证PHP是否就绪：php -v应输出类似PHP 8.1.27的版本信息；若仍显示7.4.33或更低，说明系统未启用新版源，需先执行sudo apt install -y apt-transport-https并确认/etc/apt/sources.list中含uos-v20-main条目。
配置PHP-FPM监听模式（适配Nginx/开发调试）
默认安装的PHP-FPM使用Unix socket通信，但UOS桌面版常因权限隔离导致Nginx无法访问/run/php/php*-fpm.sock，改用TCP监听可绕过此限制。
备份原始配置：sudo cp /etc/php/*/fpm/pool.d/www.conf /etc/php/*/fpm/pool.d/www.conf.bak。
编辑主池配置：sudo nano /etc/php/*/fpm/pool.d/www.conf，定位到listen =行，将其改为listen = 127.0.0.1:9000。
将user和group设为当前登录用户（如用户名为uosuser）：user = uosuser、group = uosuser，避免Web服务以root身份运行带来安全风险。
启用并启动服务：sudo systemctl enable php*-fpm && sudo systemctl start php*-fpm；验证状态：sudo systemctl is-active php*-fpm返回active即成功。
安装Composer（Linux命令行方式）
Windows用户请跳过本节，直接下载Composer-Setup.exe双击安装；本节仅适用于UOS原生终端操作，不依赖图形向导，全程可控。
方法一：一键下载+全局注册
执行三步连贯命令：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" → php composer-setup.php → sudo mv composer.phar /usr/local/bin/composer。
方法二：带完整性校验的稳妥安装
先下载安装器：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"。
校验SHA-384签名（防止中间人篡改）：php -r "if (hash_file('sha384', 'composer-setup.php') === '795f976fe0ebd8b75f26a6dd68f78fd3453ce79f32ecb33e7fd087d39bfeb978342fb73ac986cd4f54edd0dc902601dc') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"。
校验通过后执行安装：php composer-setup.php --install-dir=/usr/local/bin --filename=composer。
验证安装结果：composer -V应输出Composer version 2.7.x字样；若提示Command 'composer' not found，说明/usr/local/bin未在PATH中，执行echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc && source ~/.bashrc补全。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
