PHP源码下载与部署教程

本文详细讲解了从零开始部署和运行 PHP 源码项目的完整流程，涵盖环境验证、源码解压与目录配置、Web 服务器（Apache/Nginx）精准指向入口、关键目录权限设置，以及 Composer 依赖安装与环境初始化等核心环节，帮助开发者快速排除“源码放好了却打不开”的常见故障，真正实现开箱即用的本地或生产环境部署。

如果您已获取 PHP 项目的源码压缩包或 Git 仓库，但尚未在本地或服务器上成功运行，则可能是由于缺少运行环境、未正确配置入口文件或未启动 Web 服务。以下是部署与运行 PHP 源码的具体操作步骤：

一、确认 PHP 运行环境是否就绪

PHP 源码需依赖 PHP 解释器及配套扩展（如 mbstring、curl、openssl 等）才能正常执行。需先验证系统中是否已安装兼容版本的 PHP，并检查关键扩展是否启用。

1、在终端中执行 php -v，确认输出 PHP 版本不低于源码要求的最低版本（常见为 7.4 或 8.0+）。

2、执行 php -m | grep -E "mbstring|curl|openssl|pdo"，确认核心扩展已加载。

3、若缺失扩展，在 Ubuntu 系统中可运行 sudo apt install php-mbstring php-curl php-xml php-zip；在 CentOS 中使用 sudo yum install php-mbstring php-curl php-xml php-zip。

二、解压并放置源码至 Web 可访问目录

Web 服务器（如 Apache 或 Nginx）仅能通过特定文档根目录提供 PHP 文件服务，必须将源码置于该路径下，且确保入口脚本（如 index.php）位于可被直接请求的位置。

1、使用 tar -xzf project.tar.gz 或 unzip project.zip 解压源码到临时目录。

2、将解压后的全部内容（非外层包裹文件夹）复制至 /var/www/html/（Apache 默认根目录）或 /usr/share/nginx/html/（Nginx 默认根目录）。

3、执行 ls -l /var/www/html/，确认存在 index.php 或 public/index.php 等可访问入口文件。

三、配置 Web 服务器指向项目入口

部分项目采用前端控制器模式（如 Laravel 的 public/ 目录），需调整 Web 服务器配置，使其将所有请求转发至 index.php，而非直接暴露应用目录结构。

1、对于 Apache，进入站点配置文件（如 /etc/apache2/sites-available/000-default.conf），将 DocumentRoot 修改为项目内 public/ 子目录路径。

2、对 Nginx，在 server 块中设置 root /var/www/html/public;，并在 location ~ \.php$ 块内添加 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;。

3、重启服务：Apache 执行 sudo systemctl restart apache2，Nginx 执行 sudo systemctl restart nginx。

四、设置文件权限与所有权

PHP 进程需具备读取源码、写入日志与缓存目录的权限，否则将触发 500 错误或拒绝访问提示。

1、切换至项目根目录，执行 sudo chown -R www-data:www-data .（Ubuntu/Debian）或 sudo chown -R nginx:nginx .（CentOS/Nginx）。

2、对 storage/、bootstrap/cache/ 等可写目录，执行 sudo chmod -R 775 storage bootstrap/cache。

3、对所有 PHP 文件设置读取权限： find . -type f -name "*.php" -exec chmod 644 {} \;。

五、执行依赖安装与环境初始化

现代 PHP 项目普遍依赖 Composer 管理第三方库，且需根据实际部署环境生成专属配置文件，跳过此步将导致类未找到或数据库连接失败。

1、在项目根目录运行 php composer.phar install --no-dev --optimize-autoloader（若无 composer.phar，先下载： curl -sS https://getcomposer.org/installer | php）。

2、复制 .env.example 为 .env，用文本编辑器修改数据库主机、名称、用户名、密码等字段。

3、生成应用密钥：执行 php artisan key:generate（Laravel）或 php bin/console secret:generate（Symfony）。

好了，本文到此结束，带大家了解了《PHP源码下载与部署教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！