در این سوال قصد داریم یک کوتاه کننده لینک به کمک لاراول ایجاد کنیم.

طراحی کنترلر های این سیستم به عهده شماست.

پروژه اولیه

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

url-shortener_initial
├─ app
│   ├─ Console
│   │   └─ Kernel.php
│   ├─ Exceptions
│   │   └─ Handler.php
│   ├─ Http
│   │   ├─ Controllers
│   │   │   ├─ Auth
│   │   │   │   ├─ ForgotPasswordController.php
│   │   │   │   ├─ LoginController.php
│   │   │   │   ├─ RegisterController.php
│   │   │   │   ├─ ResetPasswordController.php
│   │   │   │   └─ VerificationController.php
│   │   │   ├─ AdminController.php
│   │   │   ├─ Controller.php
│   │   │   ├─ HomeController.php
│   │   │   └─ OwnerController.php
│   │   ├─ Middleware
│   │   │   ├─ Authenticate.php
│   │   │   ├─ CheckForMaintenanceMode.php
│   │   │   ├─ EncryptCookies.php
│   │   │   ├─ RedirectIfAuthenticated.php
│   │   │   ├─ TrimStrings.php
│   │   │   ├─ TrustProxies.php
│   │   │   └─ VerifyCsrfToken.php
│   │   └─ Kernel.php
│   ├─ Providers
│   │   ├─ AppServiceProvider.php
│   │   ├─ AuthServiceProvider.php
│   │   ├─ BroadcastServiceProvider.php
│   │   ├─ EventServiceProvider.php
│   │   └─ RouteServiceProvider.php
│   ├─ Link.php
│   └─ User.php
├─ bootstrap
│   ├─ cache
│   └─ app.php
├─ config
│   ├─ app.php
│   ├─ auth.php
│   ├─ broadcasting.php
│   ├─ cache.php
│   ├─ database.php
│   ├─ filesystems.php
│   ├─ hashing.php
│   ├─ logging.php
│   ├─ mail.php
│   ├─ queue.php
│   ├─ services.php
│   ├─ session.php
│   └─ view.php
├─ database
│   ├─ factories
│   │   ├─ LinkFactory.php
│   │   └─ UserFactory.php
│   ├─ migrations
│   │   ├─ 2014_10_12_000000_create_users_table.php
│   │   ├─ 2014_10_12_100000_create_password_resets_table.php
│   │   └─ 2018_10_16_141216_create_links_table.php
│   └─ seeds
│       ├─ DatabaseSeeder.php
│       └─ LinksTableSeeder.php
├─ public
│   ├─ css
│   │   └─ app.css
│   ├─ js
│   │   └─ app.js
│   ├─ svg
│   │   ├─ 403.svg
│   │   ├─ 404.svg
│   │   ├─ 500.svg
│   │   └─ 503.svg
│   ├─ .htaccess
│   ├─ favicon.ico
│   ├─ index.php
│   └─ robots.txt
├─ resources
│   ├─ js
│   │   ├─ components
│   │   │   └─ ExampleComponent.vue
│   │   ├─ app.js
│   │   └─ bootstrap.js
│   ├─ lang
│   │   └─ en
│   │       ├─ auth.php
│   │       ├─ pagination.php
│   │       ├─ passwords.php
│   │       └─ validation.php
│   ├─ sass
│   │   ├─ _variables.scss
│   │   └─ app.scss
│   └─ views
│       ├─ layouts
│       │   └─ app.blade.php
│       ├─ admin.blade.php
│       ├─ home.blade.php
│       ├─ login.blade.php
│       └─ owner.blade.php
├─ routes
│   ├─ api.php
│   ├─ channels.php
│   ├─ console.php
│   └─ web.php
├─ storage
│   ├─ app
│   ├─ framework
│   │   ├─ cache
│   │   ├─ sessions
│   │   ├─ testing
│   │   └─ views
│   └─ logs
├─ tests
│   ├─ CreatesApplication.php
│   └─ TestCase.php
├─ .editorconfig
├─ .env.example
├─ .gitattributes
├─ artisan
├─ composer.json
├─ composer.lock
├─ package.json
├─ phpunit.xml
├─ server.php
└─ webpack.mix.js

جزئیات

کلاس‌ها

App\Http\Controllers\HomeController

visitLink()

این تابع باید در صورت معتبر بودن آدرس کوتاه شده ورودی ، آدرس هدف را یافته و کاربر را به آن صفحه Redirect کند و در صورت نامعتبر بودن آدرس کوتاه شده، کاربر را با Session(message) با محتوای Invalid به صفحه اصلی سایت Redirect کند.

App\Http\Controllers\AdminController

addLink()

این تابع باید در صورت معتبر بودن لینک ورودی ، یک آدرس کوتاه شده و یک آدرس رمز بصورت تصادفی ایجاد کند، اطلاعات مربوط به لینک را در پایگاه داده ذخیره کرده و در انتها Session(shortened) و Session(password) را بطور صحیح تنظیم کند. این تابع در انتها باید کاربر را به صفحه اصلی سایت Redirect کند.

adminLink()

این تابع باید در صورت معتبر بودن آدرس رمز، View مربوط به خود (admin) را با محتوای صحیح نمایش دهد. در صورت نامعتبر بودن آدرس رمز، کاربر را با Session(message) با محتوای Invalid به صفحه اصلی سایت Redirect کند.

editLink()

این تابع باید در صورت معتبر بودن آدرس رمز و اطلاعات ورودی، اطلاعات لینک را به اطلاعات ورودی تغییر دهد (در صورت تکراری بودن آدرس رمز یا آدرس کوتاه شده، از تغییر پارامتر تکراری چشم پوشی کنید) و کاربر را به آدرس رمز Redirect کند. . در صورت نامعتبر بودن آدرس رمز، کاربر را با Session(message) با محتوای Invalid به صفحه اصلی سایت Redirect کند.

App\Http\Controllers\OwnerController

index()

این تابع باید اگر کاربر به عنوان صاحب سایت احراز هویت شده بود View مربوط به خود (owner) را با محتوای صحیح نمایش دهد. در غیر این صورت کاربر را به صفحه Login، Redirect می کند.

login()

این تابع باید اگر کاربر به عنوان صاحب سایت احراز هویت نشده بود View مربوط به خود (login) را نمایش دهد. در غیر این صورت کاربر را به صفحه Owner، Redirect می کند.

authenticate()

این تابع باید معتبر بودن رمز صاحب سایت را بررسی کند، در صورت صحیح بودن، تنظیمات مورد نیاز را انجام داده و سپس کاربر را به صفحه Owner، Redirect کند. در غیر این صورت کاربر را به صفحه Login، Redirect کند.

• تمام احراز هویت ها باید با استفاده از Session(IsOwner) با مقادیر true یا false انجام شود.

• برای بررسی معتبر بودن مقادیر ورودی از Validation استفاده کنید.

• هر لینک باید تنها برای تعدادی محدودی مشاهده معتبر باشد، که تعداد دفعات باقیمانده مشاهده هر لینک از روی ستون expire_after_clicks در جدول links بدست می آید و در ابتدا باید برای هر لینک مقدار آن 50 باشد. بعد از 0 شدن این عدد لینک کوتاه شده نامعتبر می شود.

• رمز صاحب سایت در فایل .env با کلید SUPER_ADMIN_PASS قرار داده شده است.

نکات

• شما تنها مجاز به تغییر فایل های app/Http/Controllers/AdminController.php و app/Http/Controllers/HomeController.php و app/Http/Controllers/OwnerController.php هستید، بقیه‌ی تغییرات نادیده گرفته می‌شوند.
• از view, route , migration ها برای فهمیدن آن‌چه باید بنویسید کمک بگیرید.
• پس از اعمال تغییرات کل پروژه به غیر از پوشه‌ی vendor را Zip کرده و ارسال کنید.
• نام فایل Zip اهمیتی ندارد.