linux

如何在Linux上部署Laravel RESTful API

小樊
47
2025-08-01 08:26:11
栏目: 智能运维

在Linux上部署Laravel RESTful API涉及多个步骤,包括安装必要的软件、配置Web服务器、设置数据库、安装Laravel以及配置API路由和控制器。以下是一个详细的步骤指南:

1. 安装必要的软件

首先,确保你的Linux系统是最新的,并且已经安装了以下软件:

安装PHP

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

安装Composer

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

安装Nginx

sudo apt install nginx

安装MySQL

sudo apt install mysql-server
sudo mysql_secure_installation

2. 配置Web服务器

配置Nginx

创建一个新的Nginx配置文件来托管你的Laravel应用:

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

添加以下内容:

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    root /var/www/yourdomain.com/public;
    index index.php index.html index.htm;

    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版本调整
        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

3. 设置数据库

登录到MySQL并创建一个新的数据库和用户:

sudo mysql -u root -p

在MySQL shell中:

CREATE DATABASE laravel_api;
CREATE USER 'api_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON laravel_api.* TO 'api_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4. 安装Laravel

导航到你的项目目录并使用Composer安装Laravel:

cd /var/www/yourdomain.com
composer create-project --prefer-dist laravel/laravel yourprojectname

将你的项目文件移动到Nginx的根目录:

sudo mv yourprojectname /var/www/yourdomain.com/public

设置正确的权限:

sudo chown -R www-data:www-data /var/www/yourdomain.com
sudo chmod -R 755 /var/www/yourdomain.com/storage
sudo chmod -R 755 /var/www/yourdomain.com/bootstrap/cache

5. 配置Laravel

编辑.env文件以配置数据库连接:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_api
DB_USERNAME=api_user
DB_PASSWORD=your_password

生成应用密钥:

cd /var/www/yourdomain.com
php artisan key:generate

运行迁移以创建数据库表:

php artisan migrate

6. 配置API路由和控制器

创建一个新的控制器:

php artisan make:controller ApiController

编辑app/Http/Controllers/ApiController.php文件,添加你的API路由和逻辑。

例如:

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class ApiController extends Controller
{
    public function index()
    {
        return response()->json(['message' => 'Welcome to the Laravel API!']);
    }
}

routes/api.php文件中定义API路由:

use App\Http\Controllers\ApiController;

Route::get('/', [ApiController::class, 'index']);

7. 启动队列(可选)

如果你需要处理后台任务,可以启动Laravel队列:

php artisan queue:work

8. 测试API

打开浏览器或使用工具(如Postman)访问你的API端点,例如:

http://yourdomain.com/api/

你应该看到返回的JSON响应:

{"message":"Welcome to the Laravel API!"}

至此,你已经在Linux上成功部署了一个Laravel RESTful API。

0
看了该问题的人还看了