如何用Debian跑PHP项目

在 Debian 上运行 PHP 项目，通常可以分为 本地开发环境 和 生产环境 两种场景。下面我按最常见、最实用的方式一步一步讲。

一、基础环境准备（必做）

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 PHP

sudo apt install php php-cli -y

查看版本：

php -v

3. 安装常用 PHP 扩展（根据项目需要）

sudo apt install php-mysql php-curl php-mbstring php-xml php-zip -y

二、最简单方式：PHP 内置服务器（适合开发）

如果你的项目是纯 PHP（如 Laravel、ThinkPHP、原生 PHP）：

cd /path/to/project
php -S 0.0.0.0:8000

浏览器访问：

http://服务器IP:8000

✅ 优点：零配置
❌ 缺点：不适合生产环境

三、使用 Nginx + PHP（推荐生产环境）

1. 安装 Nginx 和 PHP-FPM

sudo apt install nginx php-fpm -y

查看 PHP-FPM 版本（例如 php8.2-fpm）：

php -v
ls /run/php/

2. 配置 Nginx

编辑站点配置：

sudo nano /etc/nginx/sites-available/php-project

示例配置（PHP 8.2）：

server {
    listen 80;
    server_name your_domain_or_ip;

    root /var/www/php-project/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

启用站点：

sudo ln -s /etc/nginx/sites-available/php-project /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

3. 上传项目

sudo mkdir -p /var/www/php-project
sudo cp -r your_project/* /var/www/php-project/
sudo chown -R www-data:www-data /var/www/php-project

访问：

http://服务器IP

四、使用 Apache + PHP（更简单但性能一般）

sudo apt install apache2 libapache2-mod-php -y

项目放到：

/var/www/html/

访问：

http://服务器IP

五、Composer 项目（Laravel / ThinkPHP 等）

1. 安装 Composer

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

2. 安装依赖

cd /var/www/php-project
composer install

六、常见问题排查

PHP 不解析（显示源码）

• 确认 php-fpm 正在运行
• 确认 Nginx 配置了 fastcgi_pass

权限问题

sudo chown -R www-data:www-data /var/www/php-project
sudo chmod -R 755 /var/www/php-project

查看日志

sudo tail -f /var/log/nginx/error.log
sudo tail -f /var/log/php8.2-fpm.log

七、总结推荐方案

如果你愿意，可以告诉我：

• 用的是 Debian 几
• PHP 框架（Laravel / ThinkPHP / 原生）
• 是 云服务器 还是 本地虚拟机

我可以直接帮你写一份完整配置。