温馨提示×

linux怎么用laravel写接口

小樊
37
2026-10-21 18:30:20
栏目: 智能运维

下面按从零到能跑通一个接口的流程,用 Linux + Laravel 给你讲一遍,适合新手。


一、Linux 环境准备

1. 安装基础环境(以 Ubuntu 为例)

sudo apt update
sudo apt install -y php php-cli php-mbstring php-xml php-curl php-mysql unzip git

2. 安装 Composer(Laravel 依赖)

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

3. 安装 Laravel 安装器(可选)

composer global require laravel/installer

二、创建 Laravel 项目

cd /var/www
composer create-project laravel/laravel api-demo

或(用安装器):

laravel new api-demo

三、配置项目

cd api-demo
cp .env.example .env
php artisan key:generate

如需数据库:

DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

四、写一个简单接口(重点)

1. 创建控制器

php artisan make:controller Api/UserController

编辑:

// app/Http/Controllers/Api/UserController.php

namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;

class UserController extends Controller
{
    public function index()
    {
        return response()->json([
            'code' => 0,
            'msg' => 'success',
            'data' => [
                ['id' => 1, 'name' => 'Tom'],
                ['id' => 2, 'name' => 'Jack']
            ]
        ]);
    }
}

2. 配置路由(API 专用)

编辑:

// routes/api.php

use App\Http\Controllers\Api\UserController;

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

Laravel 中 api.php 里的路由默认带 /api 前缀


五、运行接口(两种方式)

方式一:Laravel 自带服务(开发用)

php artisan serve

访问:

http://127.0.0.1:8000/api/users

方式二:Nginx(生产推荐)

server {
    listen 80;
    server_name api.example.com;
    root /var/www/api-demo/public;

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

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

六、常见接口写法示例

POST 接口

Route::post('/user', function (Request $request) {
    return response()->json([
        'name' => $request->input('name')
    ]);
});

返回状态码

return response()->json($data, 201);

七、调试接口

curl http://127.0.0.1:8000/api/users

或 Postman / Apifox


八、进阶建议

  • 用 Resource 控制返回格式
  • 用 Middleware 做鉴权
  • 用 Sanctum 做 API Token
  • 用 FormRequest 做参数校验

如果你愿意,我可以:

  • 给你一个完整 RESTful API 示例
  • 教你 Laravel + MySQL 增删改查
  • 教你 Linux 部署 Laravel 到生产环境

你想继续哪一步?

0 踩