下面按在 CentOS 上从零配置 Laravel 运行环境的思路,给你一份实用、可落地的配置指南(以 CentOS 7/8 + PHP 8.x + Nginx + MySQL 为例,Laravel 9/10/11 通用)。
sudo yum update -y
sudo yum install -y epel-release
sudo yum install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx
sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
# CentOS 8 用 remi-release-8.rpm
sudo yum module reset php -y
sudo yum module enable php:remi-8.1 -y
sudo yum install -y php php-fpm php-mysqlnd \
php-mbstring php-xml php-bcmath php-json \
php-zip php-gd php-curl php-intl
sudo systemctl enable php-fpm
sudo systemctl start php-fpm
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version
sudo yum install -y mariadb-server
sudo systemctl enable mariadb
sudo systemctl start mariadb
sudo mysql_secure_installation
创建数据库:
CREATE DATABASE laravel CHARACTER SET utf8mb4;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL ON laravel.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;
cd /var/www
composer create-project laravel/laravel demo
或上传已有项目:
unzip laravel.zip -d /var/www/demo
cd /var/www/demo
composer install
sudo chown -R nginx:nginx /var/www/demo
sudo chmod -R 755 /var/www/demo
sudo chmod -R 777 /var/www/demo/storage
sudo chmod -R 777 /var/www/demo/bootstrap/cache
cp .env.example .env
php artisan key:generate
示例数据库配置:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password
编辑:
sudo vi /etc/nginx/conf.d/laravel.conf
示例配置:
server {
listen 80;
server_name yourdomain.com;
root /var/www/demo/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all;
}
}
重启 Nginx:
sudo nginx -t
sudo systemctl restart nginx
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload
SELinux(如报错):
sudo setsebool -P httpd_read_user_content 1
sudo setsebool -P httpd_can_network_connect_db 1
浏览器访问:
http://服务器IP
看到 Laravel 欢迎页即成功 ✅
| 问题 | 解决 |
|---|---|
| 500 错误 | 看 storage/logs/laravel.log |
| 权限问题 | 检查 storage / bootstrap 权限 |
| 502 | php-fpm 未启动或 sock 路径错 |
| 路由 404 | Nginx try_files 配错 |
如果你愿意,我可以:
你当前是 新项目还是已有项目迁移?CentOS 几?