在Linux上部署Laravel RESTful API涉及多个步骤,包括安装必要的软件、配置Web服务器、设置数据库、安装Laravel以及配置API路由和控制器。以下是一个详细的步骤指南:
首先,确保你的Linux系统是最新的,并且已经安装了以下软件:
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
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo apt install nginx
sudo apt install mysql-server
sudo mysql_secure_installation
创建一个新的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
登录到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;
导航到你的项目目录并使用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
编辑.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
创建一个新的控制器:
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']);
如果你需要处理后台任务,可以启动Laravel队列:
php artisan queue:work
打开浏览器或使用工具(如Postman)访问你的API端点,例如:
http://yourdomain.com/api/
你应该看到返回的JSON响应:
{"message":"Welcome to the Laravel API!"}
至此,你已经在Linux上成功部署了一个Laravel RESTful API。