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

This package is auto-updated.

Last update: 2025-04-02 09:48:29 UTC


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

安裝

  1. 下載套件
composer require jsadways/laravel-sdk
  1. 安裝套件內容
php artisan laravel-sdk:install
  1. 產生快速開發原始碼
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 () {
    // 路徑
});
  1. 套件支援檔案上傳至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=

預設安裝以下服務

  1. ConfigService #取得config設定key value使用
  2. InternalService #取得Enums資料
  3. 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>此路徑中可查閱文件內容