Laravel API Boilerplate (JWT Edition) 使用教程
1. 项目的目录结构及介绍
laravel-api-boilerplate-jwt/
├── app/
│ ├── Console/
│ ├── Exceptions/
│ ├── Http/
│ │ ├── Controllers/
│ │ ├── Middleware/
│ │ └── Requests/
│ ├── Models/
│ ├── Providers/
│ └── Rules/
├── bootstrap/
├── config/
├── database/
│ ├── factories/
│ ├── migrations/
│ └── seeds/
├── public/
├── resources/
│ ├── lang/
│ ├── views/
│ └── assets/
├── routes/
├── storage/
├── tests/
├── .env.example
├── .gitattributes
├── .gitignore
├── artisan
├── composer.json
├── composer.lock
├── phpunit.xml
├── readme.md
└── server.php
目录结构介绍
- app/: 包含应用程序的核心代码,包括控制器、模型、中间件等。
- bootstrap/: 包含启动框架的文件。
- config/: 包含应用程序的配置文件。
- database/: 包含数据库迁移、种子和工厂文件。
- public/: 包含公共资源文件,如
index.php
。 - resources/: 包含视图、语言文件和前端资源。
- routes/: 包含应用程序的路由定义。
- storage/: 包含应用程序生成的文件,如日志和缓存。
- tests/: 包含测试文件。
- .env.example: 环境配置文件示例。
- .gitattributes: Git属性配置文件。
- .gitignore: Git忽略配置文件。
- artisan: Laravel命令行工具。
- composer.json: Composer依赖配置文件。
- composer.lock: Composer锁定文件。
- phpunit.xml: PHPUnit配置文件。
- readme.md: 项目说明文档。
- server.php: 本地开发服务器启动文件。
2. 项目的启动文件介绍
public/index.php
这是应用程序的入口文件,负责启动框架并处理请求。
<?php
require __DIR__.'/../bootstrap/autoload.php';
$app = require_once __DIR__.'/../bootstrap/app.php';
$kernel = $app->make(Illuminate\Contracts\Http\Kernel::class);
$response = $kernel->handle(
$request = Illuminate\Http\Request::capture()
);
$response->send();
$kernel->terminate($request, $response);
bootstrap/app.php
这是应用程序的实例化文件,负责创建应用程序实例并注册核心服务提供者。
<?php
$app = new Illuminate\Foundation\Application(
$_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);
$app->singleton(
Illuminate\Contracts\Http\Kernel::class,
App\Http\Kernel::class
);
$app->singleton(
Illuminate\Contracts\Console\Kernel::class,
App\Console\Kernel::class
);
$app->singleton(
Illuminate\Contracts\Debug\ExceptionHandler::class,
App\Exceptions\Handler::class
);
return $app;
3. 项目的配置文件介绍
config/app.php
这是应用程序的主要配置文件,包含应用程序名称、时区、密钥等信息。
<?php
return [
'name' => env('APP_NAME', 'Laravel'),
'env' => env('APP_ENV', 'production'),
'debug' => (bool) env('APP_DEBUG', false),
'url' => env('APP_URL', 'http://localhost'),
'timezone' => 'UTC',
'locale' => 'en',
'fallback_locale' => 'en',
'key' => env('APP_KEY'),
'cipher' => 'AES-256-CBC',
'providers' => [
/*
* Laravel Framework Service Providers...
*/
Illuminate\Auth\AuthServiceProvider::class,
Illuminate\Broadcasting\