در این سؤال، شما باید یک بلاگ خیلی ساده را پیاده‌سازی کنید.

جزئیات

پروژه‌ی اولیه را از این لینک دانلود کنید. ساختار فایل‌های این پروژه به‌صورت زیر است:

simple_blog_initial
├── app
│   ├── Console
│   │   └── Kernel.php
│   ├── Exceptions
│   │   └── Handler.php
│   ├── Http
│   │   ├── Controllers
│   │   │   ├── Controller.php
│   │   │   └── PostController.php
│   │   ├── Middleware
│   │   │   ├── Authenticate.php
│   │   │   ├── EncryptCookies.php
│   │   │   ├── PreventRequestsDuringMaintenance.php
│   │   │   ├── RedirectIfAuthenticated.php
│   │   │   ├── TrimStrings.php
│   │   │   ├── TrustHosts.php
│   │   │   ├── TrustProxies.php
│   │   │   └── VerifyCsrfToken.php
│   │   └── Kernel.php
│   ├── Models
│   │   ├── FavoritePost.php
│   │   ├── Post.php
│   │   └── User.php
│   ├── Override
│   │   ├── Connection.php
│   │   └── QueryBuilder.php
│   └── Providers
│       ├── AppServiceProvider.php
│       ├── AuthServiceProvider.php
│       ├── BroadcastServiceProvider.php
│       ├── DatabaseServiceProvider.php
│       ├── EventServiceProvider.php
│       └── RouteServiceProvider.php
├── bootstrap
│   ├── cache
│   │   ├── packages.php
│   │   └── services.php
│   └── app.php
├── config
│   ├── app.php
│   ├── auth.php
│   ├── broadcasting.php
│   ├── cache.php
│   ├── cors.php
│   ├── database.php
│   ├── filesystems.php
│   ├── hashing.php
│   ├── logging.php
│   ├── mail.php
│   ├── queue.php
│   ├── services.php
│   ├── session.php
│   └── view.php
├── database
│   ├── factories
│   │   └── UserFactory.php
│   ├── migrations
│   │   ├── 2014_10_12_000000_create_users_table.php
│   │   ├── 2014_10_12_100000_create_password_resets_table.php
│   │   ├── 2019_08_19_000000_create_failed_jobs_table.php
│   │   ├── 2020_09_27_124807_create_table_posts.php
│   │   └── 2020_09_27_133130_create_table_favorite_posts.php
│   ├── seeders
│   │   └── DatabaseSeeder.php
│   └── database.sqlite
├── public
│   ├── favicon.ico
│   ├── index.php
│   ├── robots.txt
│   └── web.config
├── resources
│   ├── css
│   │   └── app.css
│   ├── js
│   │   ├── app.js
│   │   └── bootstrap.js
│   ├── lang
│   │   └── en
│   │       ├── auth.php
│   │       ├── pagination.php
│   │       ├── passwords.php
│   │       └── validation.php
│   └── views
│       ├── posts
│       │   ├── create.blade.php
│       │   ├── edit.blade.php
│       │   ├── index.blade.php
│       │   └── show.blade.php
│       └── welcome.blade.php
├── routes
│   ├── api.php
│   ├── channels.php
│   ├── console.php
│   └── web.php
├── storage
│   ├── app
│   │   └── public
│   ├── framework
│   │   ├── cache
│   │   │   └── data
│   │   ├── sessions
│   │   ├── testing
│   │   └── views
│   └── logs
├── tests
│   ├── Feature
│   │   ├── BlogSampleTest.php
│   │   ├── BlogTest.php
│   │   └── OrderByCustomTest.php
│   ├── Unit
│   ├── CreatesApplication.php
│   └── TestCase.php
├── README.md
├── artisan
├── composer.json
├── composer.lock
├── package.json
├── phpunit.xml
├── server.php
└── webpack.mix.js

راه‌اندازی پروژه

برای اجرای پروژه، باید php و composer را از قبل نصب کرده باشید.

• ابتدا پروژه‌ی اولیه را دانلود و از حالت فشرده خارج کنید.
• دستور composer install را در پوشه‌ی اصلی پروژه برای نصب نیازمندی‌ها اجرا کنید.

این بلاگ شامل صفحات زیر است:

1. صفحه‌ی نوشتن یک پست جدید (/post/create): در این صفحه با وارد کردن یک تیتر و متن محتوای یک پست، آن پست ساخته می‌شود. پس از ساخت پست، کاربر به صفحه‌ی نمایش آن پست هدایت می‌شود.
2. صفحه‌ی ویرایش یک پست (/post/edit/{id}): در این صفحه، تیتر و محتوای فعلی پست نمایش داده می‌شود و قابل ویرایش است. پس از ویرایش، کاربر به صفحه‌ی نمایش آن پست هدایت می‌شود.
3. صفحه‌ی نمایش یک پست (/post/show/{id}): در این صفحه، تیتر و محتوای پست نمایش داده می‌شود.
4. صفحه لیست تمام پست‌ها (/posts): در این صفحه، تمامی پست‌ها نمایش داده می‌شوند و با کلیک بر روی تیتر هر پست، کاربر‌ وارد صفحه‌ی نمایش آن پست می‌شود.

هر پست شامل یک تیتر و یک متن محتوا است.

هر پست پس از نوشته شدن به لیست پست‌ها در صفحه لیست تمام پست‌ها اضافه می‌شود.

مدل‌ها

مدل‌ها در پروژه‌ی اولیه داده شده است. هم‌چنین می‌توانید با اجرای دستور php artisan migrate مایگریشن‌ها را اجرا کنید و پایگاه داده را به‌طور کامل داشته باشید. در این پروژه از پایگاه داده‌ی SQLite استفاده شده است. در ادامه، لیست مدل‌ها و توضیحات آمده است:

1. Post: مدل پست‌ها که دارای دو فیلد تیتر (title) و محتوا (contents) است
2. FavoritePost: مدل پست‌های مورد علاقه که دارای یک فیلد post_id است و مشخص‌کننده‌ی پست‌های موردعلاقه است. با کلیک روی لینک «اضافه به علاقه‌مندی‌ها»، در صورتی که پست موردنظر از قبل موردعلاقه نباشد، یک ردیف به این جدول اضافه می‌شود.

شما باید PostController و viewهای مربوطه را طوری کامل کنید که عملیات ساخت، ویرایش و نمایش پست‌ها (به‌صورت تکی و در لیست) به درستی کار کند.

در صفحه‌ی نمایش یک پست و هم‌چنین صفحه نمایش لیست پست‌ها، برای هر پست دکمه‌ی «اضافه کردن به علاقه‌مندی‌ها» وجود دارد. در صفحه‌ی لیست پست‌ها، ابتدا پست‌هایی که به لیست علاقه‌مندی‌ها اضافه شده‌اند به‌ترتیب زمان اضافه شدن به علاقه‌مندی نمایش داده می‌شوند و سپس بقیه‌ی پست‌ها به‌ترتیب تاریخ ایجاد.

کنترلرها

متدهای زیر را در کنترلر PostController پیاده‌سازی کنید:

1. index(): این متد باید لیست پست‌ها را با ترتیبی که قبلاً ذکر شد با نام posts به viewposts.index ارسال کند.
2. store(Request $request): این متد باید یک پست جدید با اطلاعات ورودی (title و contents) به پایگاه داده اضافه کرده و کاربر را به صفحه‌ی /post/show/{id} هدایت کند.
3. edit($id): این متد باید اطلاعات پست با شناسه‌ی $id را با نام post به view posts.edit ارسال کند.
4. update($id, Request $request): این متد باید پست با شناسه‌ی $id را با اطلاعات ورودی (title و contents) به‌روزرسانی کرده و کاربر را به صفحه‌ی /post/show/{id} هدایت کند.
5. show($id): این متد باید اطلاعات پست با شناسه‌ی $id را با نام post به view posts.show ارسال کند.
6. favorite($id): این متد باید پست با شناسه‌ی $id را به جدول علاقه‌مندی‌ها اضافه کرده و کاربر را به صفحه‌ی قبلی‌اش هدایت کند.

برای نمایش پست‌های اضافه شده به علاقه‌مندی‌ها، شما باید در کلاس \App\Providers\DatabaseServiceProvider یک macro جدید با نام orderByCustom به QueryBuilder اضافه کنید. این macro باید به این‌صورت کار کند:

User::orderByCustom('id', 3, 7, 2, 8)->get();

کوئری معادل فراخوانی متد بالا:

select * from "users" order by (case "id" when 3 then 0 when 7 then 1 when 2 then 2 when 8 then 3 else 4 end)

هم‌چنین اگر فقط یک آرگومان به این متد داده شود (یا آرگومان‌های دوم به بعد خالی باشند)، نباید تغییری در کوئری اعمال شود.

توجه: شما تنها مجاز به تغییر فایل‌های موجود در پوشه‌ی /app هستید.

آن‌چه باید آپلود کنید

پس از اعمال تغییرات، کل پروژه به غیر از پوشه‌ی vendor را Zip کرده و آپلود کنید. نام فایل Zip اهمیتی ندارد.