温馨提示×

咋在Debian建Laravel项目

小樊
43
2026-09-11 05:44:44
栏目: 智能运维

下面给你一套在 Debian 上从零创建 Laravel 项目 的常用流程(以 Debian 11/12 为例,PHP 8.1+)。


一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装必要依赖

sudo apt install -y curl wget git unzip

三、安装 PHP 及扩展

Laravel 11 需要 PHP 8.2+(Laravel 10 可用 8.1)

1. 添加 Sury PHP 源(推荐)

sudo apt install -y lsb-release ca-certificates apt-transport-https software-properties-common
sudo curl -sSL https://packages.sury.org/php/README.txt
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

2. 安装 PHP

sudo apt install -y php8.2 php8.2-cli php8.2-common php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-mysql php8.2-bcmath php8.2-intl

检查:

php -v

四、安装 Composer

cd /tmp
curl -sS https://getcomposer.org/installer -o composer-setup.php
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer --version

五、创建 Laravel 项目

方式一:Composer 创建(推荐)

cd /var/www
composer create-project laravel/laravel myproject

方式二:Laravel 安装器

composer global require laravel/installer
export PATH="$HOME/.config/composer/vendor/bin:$PATH"
laravel new myproject

六、配置权限

cd /var/www/myproject
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

七、配置环境变量

cp .env.example .env
php artisan key:generate

八、运行开发服务器(测试)

php artisan serve

访问:

http://localhost:8000

九、(可选)用 Nginx 部署

sudo apt install -y nginx

Nginx 配置示例:

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

    index index.php;

    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;
    }
}
sudo apt install -y php8.2-fpm
sudo nginx -t
sudo systemctl restart nginx

十、常见坑

  • ❌ composer 命令不存在 → 检查 PATH
  • ❌ 权限错误 → storage 目录权限
  • ❌ PHP 版本太低 → Laravel 版本不匹配

如果你告诉我:

  • Debian 版本
  • 是否用 Nginx / Apache
  • Laravel 版本(10 / 11)

我可以给你更精确的命令。

0 踩