我们优先开发的 Blog 页面是「我的博客」页面,页面功能:

  1. 如果用户已经创建了 Blog 那么就 302 到当前登录用户的博客页面
  2. 如果用户没有创建 Blog 则显示创建页面

创建博客页面

我们先不着急开发跳转判断逻辑,先开发创建博客页面,首先,我们应该定一个路由,我们打开包的 routes/web.php 在之前定义的一个函数中定义一个「我的博客」路由:

  1. // 我的博客
  2. $route
  3. ->get('me', Web\HomeController::class.'@me')
  4. ->name('blog:me')
  5. ;

然后我们打开包的 src/Web/Controllers/HomeController.php 修改其内容如下:

  1. <?php
  2. declare(strict_types=1);
  3. namespace SlimKit\Plus\Packages\Blog\Web\Controllers;
  4. use Illuminate\Routing\Controller;
  5. class HomeController extends Controller
  6. {
  7. /**
  8. * Create the controller instance.
  9. */
  10. public function __construct()
  11. {
  12. $this
  13. ->middleware('auth:web')
  14. ->only(['me']);
  15. }
  16. /**
  17. * Home.
  18. */
  19. public function index()
  20. {
  21. return view('plus-blog::home');
  22. }
  23. /**
  24. * Create my blog page.
  25. * @param \Illuminate\Http\Request $request
  26. * @return mixed
  27. */
  28. public function me(\Illuminate\Http\Request $request)
  29. {
  30. return view('plus-blog::create-blog');
  31. }
  32. }

然后我们打开 resources/views/header.blade.php<li class=""><a href="#">我的博客</a></li> 替换为下面的内容:

  1. <li class="{{ Route::currentRouteName() === 'blog:me' ? 'active' : '' }}">
  2. <a href="{{ route('blog:me') }}">我的博客</a>
  3. </li>

我们在包的 resources/views 下面创建一个名为 create-blog.blade.php 的文件,内容如下:

<<< @/guide/dev/blog/codes/resources/views/create-blog.blade.php

创建博客逻辑

首先,我们应该创建一个「表单验证」,我们创建一个文件 src/Web/Requests/CreateBlog.php

<<< @/guide/dev/blog/codes/src/Web/Requests/CreateBlog.php

为了之后的快捷获取,以及创建的时候更加优雅,我们为 User 模型附加一个 blog 关系,我们打开包的 src/Providers/ModelServiceProvider.php 文件,在 namespace 下面,插入下面的代码:

  1. use Zhiyi\Plus\Models\User;
  2. use SlimKit\Plus\Packages\Blog\Models\Blog;

然后我们找到 registerUserMacros 方法,插入下面的内容:

  1. User::macro('blog', function () {
  2. return $this->hasOne(Blog::class, 'owner_id');
  3. });

接下来,我们打开 src/Web/Controllers/HomeController.php 在类的 namespace 下面添加代码:

  1. use Zhiyi\Plus\FileStorage\Storage;
  2. use SlimKit\Plus\Packages\Blog\Web\Requests\CreateBlog;

然后我们在 __construct 方法的 auth:web 中间件下面的 only 数组中增加 createBlog。完成后,我们在类里面写入下面的方法:

  1. /**
  2. * create a blog.
  3. * @param \SlimKit\Plus\Packages\Blog\Web\Requests\CreateBlog $request
  4. * @param \Zhiyi\Plus\FileStorage\Storage $storage
  5. * @return mixed
  6. */
  7. public function createBlog(CreateBlog $request, Storage $storage)
  8. {
  9. // 判断是否已有博客,如果有,跳转到博客页面并提示!
  10. if ($blog = $request->user()->blog) {
  11. return redirect()
  12. ->route('blog:profile', ['blog' => $blog])
  13. ->with('tip', [
  14. 'type' => 'warning',
  15. 'message' => '您已有博客,无法继续创建!'
  16. ]);
  17. }
  18. $blog = new \SlimKit\Plus\Packages\Blog\Models\Blog();
  19. $blog->slug = $request->input('slug');
  20. $blog->name = $request->input('name');
  21. $blog->desc = $request->input('desc');
  22. // 上传 Logo
  23. if ($logo = $request->file('logo')) {
  24. $resource = $storage->createResource(
  25. 'public', $storage->makePath($logo->hashName())
  26. );
  27. $storage->put($resource, $logo->get());
  28. $blog->logo = (string) $resource;
  29. }
  30. // 创建 Blog 记录
  31. $request->user()->blog()->save($blog);
  32. // 创建成功,跳转到博客页面并提示
  33. return redirect()
  34. ->route('blog:profile', ['blog' => $blog])
  35. ->with('tip', [
  36. 'type' => 'success',
  37. 'message' => '创建博客成功!'
  38. ])
  39. ;
  40. }

跳转功能

上面我们拟定了用户在没有博客的情况下创建了博客,现在我们假设用户已经有了博客,点击将跳转到我的博客页面。

我们打开包的 routes/web.php 文件,增加一个路由定义:

  1. // 博客主页
  2. $route
  3. ->get('{blog}', Web\BlogController::class.'@show')
  4. ->name('blog:profile');

然后我们打开包的博客 Model(src/Models/Blog.php),我们修改路由查找使用的 slug 进行博客查找,在模型类中写入下面的代码:

  1. /**
  2. * Get the route key for the model.
  3. *
  4. * @return string
  5. */
  6. public function getRouteKeyName()
  7. {
  8. return 'slug';
  9. }

然后我们创建在包里面创建 src/Web/Controllers/BlogController.php 文件:

<<< @/guide/dev/blog/codes/src/Web/Controllers/BlogController.php

文章关系

在上一节中,我们调用了 $blog->articles() 关系,但是这个关系现在还是不存在的,我们打开 src/Models/Blog.php 在下面的添加方法:

  1. /**
  2. * The blog has many articles.
  3. */
  4. public function articles()
  5. {
  6. return $this->hasMany(Article::class, 'blog_id');
  7. }

好了,我们整个我的博客逻辑就完成了!

页面预览

我的博客 - 图1