ubuntu跑laravel要注意什么

在 Ubuntu 上跑 Laravel（无论是开发还是生产环境），有几个常见坑和必须配置项。下面按「系统层 → PHP → Laravel → 运维」给你一个实用清单。

一、系统 & 基础环境

1. 选择合适的 Ubuntu 版本

• 推荐：Ubuntu 22.04 / 24.04 LTS
• 不要用太旧的版本（如 18.04），PHP 版本支持会受限

2. 安装必要组件

sudo apt update
sudo apt install -y git curl unzip nginx mysql-server \
php php-cli php-fpm php-mysql php-mbstring php-xml \
php-bcmath php-curl php-zip php-gd php-intl

二、PHP 注意事项（非常重要）

1. PHP 版本

• Laravel 10 → PHP 8.1+
• Laravel 11 → PHP 8.2+

查看版本：

php -v

2. 关键 PHP 配置

编辑：

sudo nano /etc/php/8.x/fpm/php.ini

建议修改：

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
cgi.fix_pathinfo=0

重启：

sudo systemctl restart php8.x-fpm

三、Web 服务器（Nginx 最常见）

1. Nginx 配置示例

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

    index index.php;

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

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

2. 千万不要把 root 指向项目根目录

❌ /var/www/laravel ✅ /var/www/laravel/public

四、Laravel 项目本身

1. 权限问题（90% 的坑）

sudo chown -R www-data:www-data /var/www/laravel
sudo chmod -R 755 /var/www/laravel
sudo chmod -R 775 storage bootstrap/cache

2. 必须执行的命令

cp .env.example .env
composer install
php artisan key:generate
php artisan migrate

五、生产环境特别注意

1. 关闭调试

.env

APP_ENV=production
APP_DEBUG=false

2. 优化配置

php artisan config:cache
php artisan route:cache
php artisan view:cache

3. 队列 & 定时任务

如果你用了：

• php artisan queue:work
• schedule:run

一定要用 supervisor 或 systemd 守护进程

六、常见坑总结

七、推荐组合（省心）

• Ubuntu + Nginx + PHP-FPM + MySQL
• Composer + Git
• Supervisor（队列）
• Certbot（HTTPS）

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

• 是 开发环境还是生产
• 用 Nginx 还是 Apache
• Laravel 版本

我可以直接给你一套可复制的配置。