如何在Linux部署Laravel API

在 Linux 上部署 Laravel API 的過程分為幾個步驟。以下是一個詳細的指南：

1. 安裝必要的軟件

首先，確保你的 Linux 系統是最新的，并且安裝了以下軟件：

• PHP：Laravel 需要 PHP 7.3 或更高版本。你可以使用包管理器來安裝 PHP。

  sudo apt update
  sudo apt install php php-cli php-fpm php-json php-common php-mysql php-zip php-mbstring php-xml php-bcmath php-curl php-pear php-bcmath
  

• Composer：Laravel 使用 Composer 來管理依賴項。

  curl -sS https://getcomposer.org/installer | php
  sudo mv composer.phar /usr/local/bin/composer
  

• Nginx 或 Apache：用于托管 Laravel 應用。

  sudo apt install nginx
  # 或者
  sudo apt install apache2
  

• MySQL 或 PostgreSQL：用于數據庫。

  sudo apt install mysql-server
  # 或者
  sudo apt install postgresql postgresql-contrib
  

2. 配置 Web 服務器

Nginx 配置

編輯 Nginx 配置文件 /etc/nginx/sites-available/default：

sudo nano /etc/nginx/sites-available/default

找到 server 部分，修改如下：

server {
    listen 80 default_server;
    listen [::]:80 default_server;

    root /var/www/your-project/public;
    index index.php index.html index.htm index.nginx-debian.html;

    server_name _;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根據你的 PHP 版本調整
    }

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

保存并退出編輯器，然后測試 Nginx 配置：

sudo nginx -t

如果沒有錯誤，重啟 Nginx：

sudo systemctl restart nginx

Apache 配置

編輯 Apache 配置文件 /etc/apache2/sites-available/000-default.conf：

sudo nano /etc/apache2/sites-available/000-default.conf

找到 <VirtualHost *:80> 部分，修改如下：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/your-project/public

    <Directory /var/www/your-project/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

保存并退出編輯器，然后啟用 Apache 虛擬主機配置：

sudo a2ensite 000-default.conf

測試 Apache 配置：

sudo apachectl configtest

如果沒有錯誤，重啟 Apache：

sudo systemctl restart apache2

3. 創建 Laravel 項目

使用 Composer 創建一個新的 Laravel 項目：

composer create-project --prefer-dist laravel/laravel your-project-name

4. 配置數據庫

進入你的 Laravel 項目目錄并配置 .env 文件：

cd /var/www/your-project
nano .env

填寫數據庫連接信息：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_username
DB_PASSWORD=your_database_password

5. 安裝依賴項

在項目目錄中運行 Composer 安裝依賴項：

composer install

6. 生成應用密鑰

生成應用密鑰：

php artisan key:generate

7. 運行數據庫遷移

運行數據庫遷移以創建表：

php artisan migrate

8. 測試 API

你可以使用 Postman 或其他 API 客戶端來測試你的 Laravel API。例如，創建一個簡單的 API 路由和控制器：

// routes/api.php
Route::get('/test', function () {
    return response()->json(['message' => 'Hello, World!']);
});

然后訪問 http://your-server-ip/api/test 來測試。

9. 設置文件權限

確保 Nginx 或 Apache 用戶（通常是 www-data）有權限訪問你的 Laravel 項目目錄和 storage 目錄：

sudo chown -R www-data:www-data /var/www/your-project
sudo chmod -R 755 /var/www/your-project/storage

10. 完成

現在你已經成功在 Linux 上部署了一個 Laravel API。你可以繼續開發和擴展你的應用。