Ubuntu 上搭建 ThinkPHP 开发环境

一 环境准备与安装

万事开头先搭台。在 Ubuntu 20.04 或 22.04 上，第一步就是把基础环境给配齐了。下面这套组合拳，能帮你快速搞定 Web 服务器、PHP 和数据库。

• 更新系统并安装基础组件（注意，PHP 版本请以你系统仓库的实际为准）：
  • 安装 Web 与 PHP：打开终端，一口气执行 sudo apt update && sudo apt install -y nginx php php-fpm php-mysql php-mbstring php-xml php-curl php-zip。这条命令会把 Nginx 和 ThinkPHP 常用到的 PHP 扩展都装上。
  • 安装数据库：继续执行 sudo apt install -y mysql-server，把 MySQL 服务也安排上。
  • 安全初始化数据库（可选但推荐）：为了安全起见，建议运行 sudo mysql_secure_installation 来设置 root 密码并移除一些默认的不安全设置。
  • 验证版本：最后，别忘了用 php -v、nginx -v、mysql --version 这几个命令检查一下，确保各个组件都正确安装并显示了版本号。
• 安装 Composer（PHP 的依赖管家）：
  • 直接通过官方脚本安装：curl -sS https://getcomposer.org/installer | php。
  • 安装完成后，把它移动到系统目录方便全局调用：sudo mv composer.phar /usr/local/bin/composer。
  • 可选提速技巧：国内访问 Packagist 可能较慢，可以设置阿里云镜像来加速：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。

二 创建项目与目录权限

基础环境就绪，接下来就是创建 ThinkPHP 项目本身，并处理好文件和数据库的权限问题。

• 使用 Composer 创建项目（这里以 ThinkPHP 6 为例，项目名可以自定义，比如叫 tp6）：
  • 执行 composer create-project topthink tp6，Composer 会自动下载框架和依赖。
  • 创建完成后，进入项目目录：cd tp6。
• 目录权限（关键一步）：为了让 Web 服务器（通常是 www-data 用户）能正常写入日志、缓存等文件，必须调整目录权限。
  • 更改所属权：sudo chown -R www-data:www-data /var/www/html/tp6。
  • 设置目录权限：sudo chmod -R 755 /var/www/html/tp6。
• 数据库准备（示例）：
  • 登录 MySQL：sudo mysql -u root -p。
  • 执行以下 SQL 语句创建数据库和专用用户（请务必替换一个强密码）：

    CREATE DATABASE tp6 DEFAULT CHARSET utf8mb4;
    CREATE USER ‘tp6’@‘localhost’ IDENTIFIED BY ‘StrongPass!’;
    GRANT ALL ON tp6.* TO ‘tp6’@‘localhost’;
    FLUSH PRIVILEGES;

三 Web 服务器配置

项目有了，得让浏览器能访问到。这里提供 Nginx 和 Apache 两种主流服务器的配置方法。

• Nginx 配置（推荐）：核心是指向项目的 public 目录，并配置好 PATHINFO 支持。
  • 新建站点配置文件：sudo nano /etc/nginx/sites-a vailablephp。
  • 写入以下配置（注意将 server_name 和 fastcgi_pass 路径按实际情况调整）：

    server {
        listen 80;
        server_name your_domain_or_ip;
        root /var/www/html/tp6/public;
        index index.php;
    
        location / {
            try_files $uri $uri/ /index.php?$query_string;
        }
    
        location ~ \.php$ {
            include snippets/fastcgi-php.conf;
            fastcgi_pass unix:/run/php/php7.4-fpm.sock; # 按实际 PHP 版本调整
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
    
        location ~ /\.env { deny all; }
    }

  • 启用站点并重启 Nginx：sudo ln -s /etc/nginx/sites-a vailablephp /etc/nginx/sites-enabled/ && sudo nginx -t && sudo systemctl restart nginx。先测试配置语法，再重启服务。
• Apache 配置（可选）：
  • 首先启用重写模块：sudo a2enmod rewrite && sudo systemctl restart apache2。
  • 配置虚拟主机（确保 DocumentRoot 指向 public 目录）：

    
        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/html/tp6/public
        
            Options Indexes FollowSymLinks
            AllowOverride All
            Require all granted
        
        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
    

  • 启用站点并重启：sudo a2ensite 000-default.conf && sudo systemctl restart apache2。

四 框架配置与本地开发启动

服务器配好了，最后一步是让框架“认识”你的数据库，并顺利跑起来。

• 配置数据库连接：ThinkPHP 优先使用根目录下的 .env 文件进行配置。
  • 如果不存在 .env 文件，可以复制 .example.env 创建。编辑 .env，填入你的数据库信息：

    DB_TYPE=mysql
    DB_HOST=127.0.0.1
    DB_NAME=tp6
    DB_USER=tp6
    DB_PASSWORD=StrongPass!
    DB_PORT=3306
    DB_PREFIX=

• 开发环境启动：
  • 内置服务器（仅用于开发测试）：在项目目录下执行 cd /var/www/html/tp6 && php think run。
  • 然后在浏览器访问：https://your_domain_or_ip:8000（内置服务器默认端口是 8000）。
• 常见问题快速排查：
  • 502 Bad Gateway：先检查 PHP-FPM 服务是否在运行（systemctl status php7.4-fpm），再确认 Nginx 配置中 fastcgi_pass 的路径（如 sock 文件路径）是否与 /etc/php/7.4/fpm/pool.d/www.conf 中的 listen 设置一致。
  • 路由 404：问题多半出在 Nginx 配置上，请确保 location / 块里包含了 try_files $uri $uri/ /index.php?$query_string; 这一行。
  • 权限错误：如果运行时提示目录不可写，请再次确认 runtime 目录的拥有者是 www-data 用户。

五 生产环境建议

开发调试没问题了，但如果要上线，还有几个关键点必须注意。

• 关闭调试模式：这是安全底线。在 .env 文件中设置 APP_DEBUG=false，或者在 config/app.php 里设置 ‘app_debug’ => false。
• 性能与安全加固：启用 PHP 的 OPcache 提升性能；考虑使用 Redis 来管理会话和缓存；严格限制对 .env 配置文件的访问（前面的 Nginx 配置示例已包含相关规则）；定期使用 composer update 更新框架和依赖以修复安全漏洞。
• 启用 HTTPS：使用 Let‘s Encrypt 的 Certbot 工具可以免费获取 SSL 证书。例如对于 Apache，可以运行：sudo certbot --apache -d your_domain_or_ip，它会自动配置并设置证书自动续期。
• 日志排查：出问题时，日志是第一现场。Nginx 错误日志通常在 /var/log/nginx/error.log，Apache 则在 /var/log/apache2/error.log。