本篇將涵蓋環境設置和基礎結構的搭建,包括 Laravel 框架的初始化、路由設置、資料庫遷移和模型的建立。下篇將進一步討論核心功能的實現,包括 API 的開發和核心邏輯的實作。

上篇: 如何在laravel實作縮網址系統-系統架構篇
初始化 Laravel 專案
安裝 Composer:
- 如果尚未安裝 Composer,可以從 Composer 官方網站 下載並安裝。
建立 Laravel 專案:
$ composer create-project —prefer-dist laravel/laravel url-shortener
- url-shortener 是專案名稱,執行此命令後,Laravel 將自動生成專案文件夾並安裝所需的依賴包。
進入專案目錄:
$ cd url-shortener
設置環境配置:
複製 .env.example 文件並重命名為 .env。
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=url_shortener
DB_USERNAME=root
DB_PASSWORD=yourpassword
設置應用的基本配置信息,例如 APP_NAME 和 APP_URL。
生成應用程序密鑰:
$ php artisan key:generate
這將生成並設置一個唯一的應用程序密鑰到 .env 文件中。
建立資料表結構
建立資料表遷移檔案:
$ php artisan make:migration create_short_urls_table
- 這將在 database/migrations 文件夾中生成一個新的遷移文件。
設置資料表遷移:
- 打開剛剛生成的遷移文件,並在其中定義 urls 表的結構。主要包括 id, original_url, short_code, created_at, updated_at 等欄位。
執行資料表遷移:
$ php artisan migrate
建立模型與工廠
創建 Eloquent 模型:
$ php artisan make:model Models/ShortUrl
- 這將在 app/Models 目錄下生成 Url.php 模型文件。
設置模型屬性:
- 在 Url 模型中,定義可填充的屬性 original_url 和 short_code,以及相關的資料表名稱。
建立工廠類別(這個我們以後會再詳細介紹):
$ php artisan make:factory UrlFactory --model=Url
- 在工廠文件中,定義如何生成 original_url 和 short_code 的假資料。
設置基本路由和控制器
設置基本路由:
- 打開 routes/api.php 文件,定義基礎的 API 路由,例如縮短 URL 和查詢短網址的路由。
建立控制器:
$ php artisan make:controller UrlShortenerController
- 在控制器中定義處理 API 請求的方法,例如生成短網址和查詢短網址的方法。
連接控制器與路由:
- 將定義好的路由與 UrlController 中的方法連接,使得 API 請求能夠正確地映射到控制器中的具體邏輯。
到目前為止,我們已經完成了 Laravel 框架的初始化、資料庫的設置、模型和控制器的建立,並且基本設置了路由。
這為接下來的實作打下了基礎。在下篇中,我們將進一步實現核心功能,包括短網址的生成、查詢以及相關的 API 開發。
如果有興趣的格友或是路過的朋友,可以嘗試的建立看看~,那我們下篇見