debian

Laravel框架在Debian上的配置步骤是什么

小樊
38
2025-10-17 02:25:47
栏目: 智能运维

Laravel框架在Debian上的配置步骤

1. 更新系统

首先确保Debian系统及软件包为最新版本,避免兼容性问题:

sudo apt update && sudo apt upgrade -y

2. 安装必要依赖

Laravel需要PHP及多个扩展支持,安装常用依赖包(以PHP 8.2为例,根据实际版本调整):

sudo apt install -y git curl php-cli php-fpm php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath

3. 安装Composer

Composer是PHP依赖管理工具,用于安装Laravel及项目依赖:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
# 验证安装
composer --version

4. 安装Web服务器(以Nginx为例)

Laravel推荐使用Nginx,安装并启动服务:

sudo apt install -y nginx
sudo systemctl start nginx
sudo systemctl enable nginx  # 开机自启

5. 配置Nginx虚拟主机

创建Nginx配置文件(替换yourdomain.com为实际域名/IP,/var/www/yourproject为项目路径):

sudo nano /etc/nginx/sites-available/yourdomain.com

粘贴以下内容(根据PHP版本调整fastcgi_pass路径,如PHP 8.2对应/run/php/php8.2-fpm.sock):

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /var/www/yourproject/public;
    index index.php index.html;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

启用配置并测试语法:

sudo ln -s /etc/nginx/sites-available/yourdomain.com /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置是否正确
sudo systemctl restart nginx

6. 创建Laravel项目

使用Composer创建新项目(替换yourproject为项目名称):

cd /var/www
composer create-project --prefer-dist laravel/laravel yourproject

7. 配置PHP-FPM

确保PHP-FPM以www-data用户运行(默认已配置,无需修改),重启服务:

sudo systemctl restart php8.2-fpm

8. 设置文件权限

Laravel的storagebootstrap/cache目录需要可写权限:

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

9. 配置数据库

安装MariaDB/MySQL并创建数据库及用户(以MySQL为例):

sudo apt install -y mariadb-server
sudo mysql_secure_installation  # 完成安全设置

登录MySQL并执行:

CREATE DATABASE laravel_db;
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

10. 配置Laravel环境

复制.env.example.env并编辑(替换数据库信息):

cd /var/www/yourproject
cp .env.example .env
nano .env

修改以下内容(根据实际数据库信息调整):

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=your_strong_password
APP_ENV=production
APP_DEBUG=false
APP_KEY=  # 生成密钥后会自动填充

生成应用密钥:

php artisan key:generate

11. 运行数据库迁移

执行迁移以创建数据库表结构:

php artisan migrate

12. 可选优化

完成以上步骤后,通过浏览器访问http://yourdomain.com即可看到Laravel欢迎页面。

0
看了该问题的人还看了