Linux Laravel如何搭建服务器环境

Linux 上搭建 Laravel 服务器环境

一准备与版本选择

以 Ubuntu/Debian 或 CentOS/RHEL 为例，先更新系统并安装基础工具。
选择 LEMP（Nginx + PHP-FPM + MySQL）或 LAMP（Apache + mod_php + MySQL）。
当前 Laravel 版本通常要求 PHP 8.0+，并启用常见扩展：php-cli php-fpm php-mysql php-mbstring php-xml php-curl php-zip php-gd php-bcmath。可用 php -v 与 php -m 检查版本与扩展。

二 Ubuntu 或 Debian 搭建步骤

安装组件
- LEMP：
  - sudo apt update && sudo apt install nginx mysql-server php-fpm php-mysql php-mbstring php-xml php-curl php-zip php-gd php-bcmath
- LAMP：
  - sudo apt update && sudo apt install apache2 mysql-server libapache2-mod-php php-mysql php-mbstring php-xml php-curl php-zip php-gd php-bcmath
安装 Composer
- curl -sS https://getcomposer.org/installer | php
- sudo mv composer.phar /usr/local/bin/composer
创建项目（可选）
- composer create-project --prefer-dist laravel/laravel my_laravel
- cd my_laravel
配置 Laravel
- cp .env.example .env
- php artisan key:generate
- 编辑 .env 配置数据库等敏感信息

Web 服务器配置

Nginx 示例（/etc/nginx/sites-available/laravel）：

server {
    listen 80;
    server_name your_domain_or_ip;
    root /var/www/my_laravel/public;
    index index.php index.html;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Content-Type-Options "nosniff";

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 按实际 PHP 版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

启用站点：sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled
校验并重启：sudo nginx -t && sudo systemctl reload nginx

Apache 要点：启用 mod_rewrite，虚拟主机 DocumentRoot 指向 /public，且 <Directory> 中 AllowOverride All。

三 CentOS 或 RHEL 搭建步骤

安装 EPEL 与 Remi 仓库（以 PHP 8.1 为例）
- sudo yum install epel-release -y
- sudo yum install https://rpms.remirepo.net/enterprise/remi-release-8.rpm -y
- sudo dnf module reset php -y && sudo dnf module enable php:remi-81 -y
安装组件
- sudo yum install nginx mysql-server php php-fpm php-mysqlnd php-mbstring php-xml php-curl php-zip php-gd php-bcmath -y
启动服务
- sudo systemctl enable --now nginx php-fpm mysqld
Composer 与项目
- 安装 Composer（同 Ubuntu 步骤）
- 创建项目或上传代码，执行 php artisan key:generate
Nginx 配置（两种方式，二选一）
- Unix Socket（推荐）：fastcgi_pass unix:/var/run/php-fpm/www.sock;
- TCP 端口：fastcgi_pass 127.0.0.1:9000;（需确保 php-fpm 监听 9000）
- 其余 try_files 与安全头配置与上文 Nginx 示例一致
防火墙
- sudo firewall-cmd --permanent --add-service=http
- sudo firewall-cmd --reload

四数据库与权限安全

初始化与安全加固
- sudo mysql_secure_installation
创建数据库与用户
- CREATE DATABASE laravel_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
- CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'StrongPassword!';
- GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';
- FLUSH PRIVILEGES;

Laravel 环境变量

.env 中设置：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=StrongPassword!

文件权限
- Web 服务运行用户通常为 www-data（Debian/Ubuntu）或 nginx（CentOS/RHEL）
- sudo chown -R www-data:www-data /var/www/my_laravel/storage /var/www/my_laravel/bootstrap/cache
- sudo chmod -R 775 /var/www/my_laravel/storage /var/www/my_laravel/bootstrap/cache
可选优化
- 生产环境执行：php artisan config:cache、php artisan route:cache、php artisan view:cache

五验证与常见问题

访问测试
- 浏览器打开 http://your_domain_or_ip，应看到 Laravel 欢迎页
- 开发阶段可临时使用 php artisan serve，但生产环境请使用 Nginx/Apache
日志排查
- Nginx：/var/log/nginx/error.log
- PHP-FPM：/var/log/php-fpm.log 或 /var/log/php8.1-fpm.log
- Laravel：storage/logs/laravel.log
常见错误
- 页面空白或 500：检查 .env 配置、APP_KEY、storage/bootstrap/cache 权限、PHP 错误日志
- 路由 404：确认 Nginx try_files $uri $uri/ /index.php?$query_string; 与 root 指向 /public
- 权限被拒：确认目录属主为 www-data/nginx 且权限 775
- 数据库连接失败：核对 .env 中 DB_HOST/DB_PORT/DB_USERNAME/DB_PASSWORD 与数据库是否允许该用户远程/本地访问

最新问答

相关标签