在 Debian 上使用 PHP 框架的标准流程
在 Debian 上使用 PHP 框架（如 Laravel、Symfony、ThinkPHP、CakePHP）通常包括：安装 PHP 与常用扩展、安装 Composer、用 Composer 创建项目、配置 Nginx/Apache + PHP-FPM（或 mod_php）、配置数据库与路由、设置文件权限与优化。以下给出可直接复用的步骤与示例配置。
一 环境准备
- 更新索引并安装 PHP 与常用扩展（按你的 Debian 版本选择 PHP 版本包名，如 php8.2、php8.3）：
- sudo apt update
- sudo apt install php php-cli php-fpm php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath
- 安装 Composer（PHP 依赖管理工具）：
- curl -sS https://getcomposer.org/installer | php
- sudo mv composer.phar /usr/local/bin/composer
- 安装数据库（按需其一或多种）：
- sudo apt install mysql-server 或 sudo apt install postgresql
- 安装 Web 服务器（二选一或并存）：
- sudo apt install nginx
- 或 sudo apt install apache2
二 创建项目
- Laravel（示例）：
- composer create-project --prefer-dist laravel/laravel your-project-name
- cd your-project-name
- Symfony（示例）：
- composer create-project symfony/website-skeleton your-project-name
- ThinkPHP（示例）：
- 将项目上传至 /var/www/your_tp（或使用 Git 克隆），后续在框架配置中设置数据库连接
- CakePHP（示例）：
- composer create-project --prefer-dist cakephp/app myapp
- cd myapp
- 开发环境可直接启动内置服务器：bin/cake server（默认端口 8765）
三 配置 Web 服务器
- Nginx + PHP-FPM（通用，推荐用于 Laravel/Symfony/ThinkPHP）
- 站点配置示例（/etc/nginx/sites-available/your-project）：
- server {
- listen 80;
- server_name your-domain.com;
- root /path/to/your-project/public; # 注意指向框架的 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:/var/run/php/php8.2-fpm.sock; # 按实际 PHP 版本调整
- fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
- include fastcgi_params;
- }
- }
- 启用站点并重启：
- sudo ln -s /etc/nginx/sites-available/your-project /etc/nginx/sites-enabled/
- sudo nginx -t && sudo systemctl reload nginx
- 确保 PHP-FPM 运行：
- sudo systemctl enable --now php8.2-fpm
- Apache（替代方案，适合 ThinkPHP 等）
- 启用重写模块：sudo a2enmod rewrite
- 虚拟主机示例（/etc/apache2/sites-available/your-project.conf）：
- <VirtualHost *:80>
- DocumentRoot /path/to/your-project/public
- <Directory /path/to/your-project/public>
- Options Indexes FollowSymLinks
- AllowOverride All
- Require all granted
-
-
- 启用站点并重启：
- sudo a2ensite your-project.conf
- sudo systemctl reload apache2
四 配置数据库与框架
- 创建数据库与用户（以 MySQL 为例）：
- CREATE DATABASE your_database_name;
- CREATE USER ‘your_username’@‘localhost’ IDENTIFIED BY ‘StrongPassword’;
- GRANT ALL ON your_database_name.* TO ‘your_username’@‘localhost’;
- FLUSH PRIVILEGES;
- Laravel 配置与迁移：
- 编辑 .env：
- DB_CONNECTION=mysql
- DB_HOST=127.0.0.1
- DB_PORT=3306
- DB_DATABASE=your_database_name
- DB_USERNAME=your_username
- DB_PASSWORD=your_password
- 生成表结构：php artisan migrate
- ThinkPHP 配置：
- 在项目的 .env 或配置文件中设置数据库连接（示例）：
- DB_TYPE=mysql
- DB_HOST=127.0.0.1
- DB_NAME=your_database_name
- DB_USER=your_username
- DB_PWD=your_password
- DB_PORT=3306
- 路由与控制器（以 Laravel API 为例）：
- php artisan make:controller ApiController
- routes/api.php：
- Route::get(‘/’, [ApiController::class, ‘index’]);
- Route::get(‘/user/{id}’, [ApiController::class, ‘getUser’]);
- 示例控制器方法：
- public function index() { return response()->json([‘message’ => ‘Hello, World!’]); }
- public function getUser($id) { return response()->json([‘id’ => $id, ‘name’ => ‘John Doe’]); }
五 运行与优化
- 开发环境快速启动
- Laravel：php artisan serve（便于本地调试）
- CakePHP：bin/cake server（默认端口 8765）
- 生产环境要点
- 使用 HTTPS（如 Let’s Encrypt 证书），并配置强密钥与缓存
- 设置正确的文件权限（如 storage、bootstrap/cache 目录可被 Web 服务写入）
- 配置 OPcache 提升性能（在 php.ini 中启用并调优）
- 防火墙放行 80/443：sudo ufw allow ‘Nginx Full’ 或 sudo ufw allow ‘Apache Full’
- 常见问题排查
- 路由 404：确认 Web 服务器将请求转发到框架的 public/index.php（Nginx 的 try_files 与 PHP-FPM 配置是否正确）
- 权限错误：检查 storage、cache 目录属主与权限
- 数据库连接失败：核对 .env 中 DB_HOST/DB_PORT/DB_USER/DB_PASS 与数据库是否允许连接
- 类未找到/依赖缺失：在项目目录执行 composer install --optimize-autoloader --no-dev
