首先确认PHP环境已安装并启用必要扩展，通过php -v和php -m验证版本与模块；接着解压源码至Web服务器根目录如/var/www/html/，确保index.php等入口文件存在；然后配置Apache或Nginx将请求指向项目public目录，并重启服务；随后设置文件权限，将所有权赋予www-data或nginx用户，并为storage等目录赋予775写入权限；最后运行composer install安装依赖，复制.env.example为.env并配置数据库信息，生成应用密钥以完成初始化。
如果您已获取 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"，确认核心扩展已加载。
立即学习“PHP免费学习笔记（深入）”；
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）。
