jsadways / laravel-sdk
There is no license information available for the latest version (1.0.6) of this package.
1.0.6
2025-04-02 09:48 UTC
Requires
- intervention/image: ^3.10
- jsadways/authenticator: ^1.0.0
- jsadways/data-api: ^1.0.0
- jsadways/operationrecord: ^1.0.0
- jsadways/scopefilter: ^1.0.0
- mavinoo/laravel-batch: ^2.4
- spatie/laravel-google-cloud-storage: ^2.3
README
laravel-sdk是基於laravel 10的快速開發套件
以資料表結構為基礎快速產生相對應controller、Model、Repository
並在Model檔案中提供_schema結構用於資料傳入快速驗證
安裝完成後基礎Create Update Read 已經完備
設計你的資料表
在安裝laravel-sdk快速開發套件前,先確認所有需要的資料表都已經建立
透過原生指令建立你所需要的所有資料表
php artisan make:migrate create_xxx_table
產生所有資料表
php artisan migrate
安裝
- 下載套件
composer require jsadways/laravel-sdk
- 安裝套件內容
php artisan laravel-sdk:install
- 產生快速開發原始碼
php artisan laravel-sdk:code-init API
註: API指的是會將route路徑產生在route/api.php中,並且將所有controller都生成在API資料夾內,如未指定則會產出在route/web.php中 4. 在專案 .env 添加帳號驗證網址與前端網址
JS_AUTH_HOST='http://authenticate.tw'
FORESTAGE_URL='http://172.16.1.156:3100/struct'
如使用自訂義登入驗證系統則不需要FORESTAGE_URL
5. 套件有提供 Middleware 驗證功能,名稱為 js-authenticate-middleware-alias,可依需求加入route中
// 在需驗證位置加入 js-authenticate-middleware-alias 中間件
Route::middleware(['js-authenticate-middleware-alias'])->group(function () {
// 路徑
});
- 套件支援檔案上傳至GCS,可修改
config/filesystem.php
,增加以下資訊
'disks' => [
...
'gcs' => [
'driver' => 'gcs',
'key_file_path' => env('GOOGLE_CLOUD_KEY_FILE', null), // optional: /path/to/service-account.json
'key_file' => [], // optional: Array of data that substitutes the .json file (see below)
'project_id' => env('GOOGLE_CLOUD_PROJECT_ID', 'your-project-id'), // optional: is included in key file
'bucket' => env('GOOGLE_CLOUD_STORAGE_BUCKET', 'your-bucket'),
'path_prefix' => env('GOOGLE_CLOUD_STORAGE_PATH_PREFIX', ''), // optional: /default/path/to/apply/in/bucket
'storage_api_uri' => env('GOOGLE_CLOUD_STORAGE_API_URI', null), // see: Public URLs below
'api_endpoint' => env('GOOGLE_CLOUD_STORAGE_API_ENDPOINT', null), // set storageClient apiEndpoint
'visibility' => 'public', // optional: public|private
'visibility_handler' => null, // optional: set to \League\Flysystem\GoogleCloudStorage\UniformBucketLevelAccessVisibility::class to enable uniform bucket level access
'metadata' => ['cacheControl' => 'public,max-age=86400'], // optional: default metadata
],
...
]
以及修改專案中.env檔案
FILESYSTEM_DISK=gcs
GOOGLE_CLOUD_PROJECT_ID=GCP_PROJECT_ID
GOOGLE_CLOUD_KEY_FILE=LOCATION_OF_KEY_FILE
GOOGLE_CLOUD_STORAGE_BUCKET=BUCKET_NAME
GOOGLE_CLOUD_STORAGE_PATH_PREFIX=
GOOGLE_CLOUD_STORAGE_API_URI=
預設安裝以下服務
- ConfigService #取得config設定key value使用
- InternalService #取得Enums資料
- FileColumnProcessService #針對Create Update Delete處理相對應的檔案
提供資料生成指令
Create Controller
php artisan make:sdk-controller API/MemberController
#生成 app/Http/Controllers/API/MemberController.php
以及 app/Core/Controllers/Member/MemberContract.php
Create Model
php artisan make:sdk-model Member
#生成 app/Models/Member.php
並依據Member table column產生 _schema() method內容
Create Repository
php artisan make:sdk-repository MemberRepository
#生成 app/Repositories/MemberRepository.php
以及 app/Core/Repositories/Member/Dtos/CreateMemberDto.php 新增資料時的傳入物件內容
以及 app/COre/Repositories/Member/Dtos/UpdateMemberDto.php 更新資料時的傳入物件內容
可再依照使用情境修改
Create Enum
php artisan make:sdk-enum Member/Status --cases=On,Off
#生成 app/Core/Enums/Member/Status.php
需要再手動修改檔案中每個case的Description與style_class屬性
Create API Documents
php artisan app:docs
#依照route/api.php中定義的每條路徑以及每個model中定義好的_schema()產生api文件
在<http://PROJECT_URL/docs-api>此路徑中可查閱文件內容