ubuntu装thinkphp要什么依赖

ubuntu

小樊

2026-10-01 15:31:20

栏目: 编程语言

在 Ubuntu 上运行 ThinkPHP（无论是 5.x 还是 6.x / 8.x），通常需要以下依赖和环境。下面按「最小可用」和「常见完整环境」来说明。

一、基础系统依赖

sudo apt update
sudo apt install -y \
    nginx \
    php \
    php-fpm \
    php-cli \
    php-mysql \
    php-mbstring \
    php-xml \
    php-curl \
    php-zip \
    php-gd \
    php-bcmath \
    composer

如果你用 Apache：

sudo apt install -y apache2 libapache2-mod-php

二、PHP 版本建议

ThinkPHP 版本	推荐 PHP 版本
ThinkPHP 5.1	PHP 7.1+
ThinkPHP 6.0	PHP 7.2+
ThinkPHP 6.1	PHP 7.4+
ThinkPHP 8.0	PHP 8.0+

Ubuntu 20.04 / 22.04 默认 PHP 版本通常够用
如需新版 PHP（如 8.2）：

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.2 php8.2-fpm

三、Composer（必须）

ThinkPHP 使用 Composer 管理依赖：

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

验证：

composer -V

四、数据库（按需）

MySQL / MariaDB

sudo apt install -y mysql-server
# 或
sudo apt install -y mariadb-server

PHP 扩展：

php-mysql

Redis（可选但常用）

sudo apt install -y redis-server php-redis

五、ThinkPHP 本身

composer create-project topthink/think tp

或已有项目：

composer install

六、目录权限（非常重要）

chmod -R 755 tp
chown -R www-data:www-data tp

确保：

runtime/ 可写
storage/（TP6/8）可写

七、Web 服务器配置示例（Nginx）

server {
    listen 80;
    server_name example.com;
    root /var/www/tp/public;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

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

八、常见坑提醒

❌ 直接访问 index.php 在外层
✅ 必须指向 public/
❌ runtime 没写权限 → 白屏
✅ 开发环境开启调试：

// .env
APP_DEBUG = true

如果你告诉我：

ThinkPHP 版本
Ubuntu 版本
用 Nginx 还是 Apache

我可以给你一套精确安装命令。