首先使用Composer优化依赖并生成自动加载，接着创建打包脚本排除无关文件，然后分离配置环境并通过SSH传输部署包，最后配置Web服务器指向public目录并重启服务。
如果您正在开发一个PHP项目，并希望将其打包并部署到生产环境，您需要完成一系列标准化操作以确保代码的稳定性与可维护性。以下是实现PHP项目打包与部署的具体步骤。
本文运行环境：Dell XPS 13，Ubuntu 24.04
一、使用Composer进行依赖管理与优化
在打包PHP项目之前，必须确保所有外部依赖都已正确声明并锁定版本，避免在不同环境中出现兼容性问题。通过Composer可以统一管理这些依赖。
1、打开终端并进入项目根目录，执行命令 composer install --optimize-autoloader --no-dev 以安装生产环境所需依赖并优化自动加载性能。
立即学习“PHP免费学习笔记（深入）”；
2、运行 composer dump-autoload --optimize 进一步提升类加载效率。
3、确认 composer.json 文件中 autoload 配置正确，并包含 PSR-4 或 PSR-0 的命名空间映射。
二、构建自动化打包脚本
为了减少人为错误并提高部署效率，应编写一个可重复执行的打包脚本，用于收集必要文件并排除无关内容。
1、创建名为 build.sh 的 Shell 脚本文件，添加执行权限：chmod +x build.sh。
2、在脚本中定义源目录和目标归档名称，使用 tar 命令打包核心文件，例如：tar -czf project-release-$(date +%Y%m%d).tar.gz --exclude='tests' --exclude='*.log' --exclude='*.md' --exclude='*.git*' *。
3、确保 vendor/ 目录已被包含（前提是已执行 composer install），同时排除本地配置文件如 .env.local 或 config.php.bak。
三、配置环境分离机制
生产环境与开发环境应使用不同的配置参数，防止敏感信息泄露或错误连接测试数据库。
1、创建 config.production.php 和 config.development.php 两个独立配置文件，仅将通用部分提取至 config.php。
2、在入口文件 index.php 中根据主机名或环境变量判断加载哪个配置：if (getenv('APP_ENV') === 'production') 则引入生产配置。
3、在服务器上通过 export APP_ENV=production 设置环境变量，确保逻辑分支正确执行。
四、通过SSH传输并解压部署包
将本地打包完成的项目安全地传输到远程服务器是部署的关键环节，需保证传输过程加密且文件完整。
1、使用 scp 命令将生成的 tar.gz 文件上传至目标服务器：scp project-release-20250405.tar.gz user@server:/var/www/html/。
2、登录远程服务器并进入网站根目录，执行解压命令：tar -xzf project-release-20250405.tar.gz --strip-components=0 -C /var/www/html/。
3、更改文件所有权为Web服务用户，例如：chown -R www-data:www-data /var/www/html/，以确保PHP进程有读取权限。
五、设置Web服务器虚拟主机
Apache或Nginx需要正确指向项目的 public/ 或 web/ 子目录作为文档根路径，以防止直接访问内部PHP文件。
1、编辑 Nginx 配置文件 /etc/nginx/sites-available/default，在 server 块中设置 root 指令指向项目下的 public 文件夹：root /var/www/html/public;。
2、添加 location 块处理 PHP 请求，确保 fastcgi_pass 正确指向 PHP-FPM socket 地址。
3、重启 Nginx 服务：systemctl restart nginx，使新配置生效。
