英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Laravel 11.x 博客

此代码库的目的是展示在 Laravel 上的良好开发实践，并展示框架功能的使用案例，例如：

• 身份验证
• API
  • Sanctum
  • API 资源
  • 版本管理
• Blade
• 广播
• 缓存
• 邮箱验证
• 文件系统
• 帮助函数
• Horizon
• 本地化
• 邮件
• 数据库迁移
• 策略
• 服务提供者
• 请求
• 填充与工厂
• 测试
• Homestead

除了 Laravel，这个项目还使用其他工具，例如：

• Bootstrap 5.x
• Pint
• Font Awesome
• Hotwired
• Redis
• spatie/laravel-medialibrary
• hotwired-laravel/turbo-laravel
• 还有更多等待发现。

一些截图

你可以在以下链接查看应用程序的一些截图：https://imgur.com/a/Jbnwj

安装

要创建你的开发环境，请按照这些说明操作。

在你的本地机器上设置开发环境：

$ git clone https://github.com/guillaumebriday/laravel-blog.git
$ cd laravel-blog
$ cp .env.example .env
$ php artisan key:generate
$ php artisan horizon:install
$ php artisan telescope:install
$ php artisan storage:link

现在打开 http://laravel-blog.test。

邮件发送器

你可以使用 Mailpit 在开发中测试你的邮件。

安装完成后，打开 http://localhost:8025。

开始之前

你需要运行带有种子的迁移：

$ php artisan migrate:fresh --seed

这将创建一个您可以用来登录的新用户：

email: demo@demo.com
password: demodemo

然后，编译资源：

$ yarn dev

开始为通讯做工作：

$ php artisan tinker
> PrepareNewsletterSubscriptionEmail::dispatch();

有用的命令

启动 Laravel Horizon：

$ php artisan horizon

正在为数据库播种：

$ php artisan db:seed

正在运行测试：

$ php artisan test

Run Laravel Pint:

$ ./vendor/bin/pint --verbose --test

正在生成备份：

$ php artisan vendor:publish --provider="Spatie\Backup\BackupServiceProvider"
$ php artisan backup:run

生成假数据：

$ php artisan db:seed --class=DevDatabaseSeeder

探索套餐

$ php artisan package:discover

在开发环境中，重建数据库：

$ php artisan migrate:fresh --seed

访问 API

客户可以访问 REST API。API 请求需要通过 Bearer 令牌进行身份验证。

生成新令牌：

curl --location --request POST 'laravel-blog.test/api/v1/authenticate?email=your_email&password=your_password' \
     --header 'X-Requested-With: XMLHttpRequest'

现在你可以将 meta.access_token 键作为你的 Bearer 令牌使用：

curl --location 'laravel-blog.test/api/v1/posts' \
      --header 'X-Requested-With: XMLHttpRequest' \
      --header 'Authorization: Bearer access_token'

API 前缀为 api，并带有 API 版本号，例如 v1。

不要忘记将 X-Requested-With 头设置为 XMLHttpRequest。否则，Laravel 不会将调用识别为 AJAX 请求。

列出 API 的所有可用路由：

$ php artisan route:list --path=api

贡献

请随时通过适配或添加功能来为项目做贡献！欢迎提交错误报告或拉取请求。

许可证

本项目在 MIT 许可下发布。