Skip to content

Latest commit

 

History

History
120 lines (84 loc) · 2.73 KB

README.md

File metadata and controls

120 lines (84 loc) · 2.73 KB

Laravel 基礎模板

這是一項起始基於 Laravel Boilerplate 下去改進的專案，加入了一些自己對於系統的想法、追求更新的版本，適合作為專案或系統開發的起始模板，大部分需要的功能都已經完善了，讓開發者可以只需要專注在自己系統的特色功能。

特色

功能面

  1. 全面支援中文
  2. 支援二階段身份驗證(2FA)
  3. 具有公告系統(Announcement)
  4. 基於以角色為基礎的存取控制(RBAC)的使用者、角色、權限管理系統

技術面

  • Laravel 9.x
  • Vue 3.x
  • Bootstrap 5.x
  • CoreUI 4.x

預計接下來的項目

  • 完整移除 jQuery 依賴
  • 新增公告系統(Announcement)於後台的新增、刪除、修改、查詢，以及權限管理

安裝

自行架設環境

  1. 克隆此 Laravel-Template
# Clone this repository
git clone https://github.com/Kantai235/Laravel-Template.git

# Enter the repository
cd Laravel-Template
  1. 建立一個 .env 的設定檔案，並將 .env.example 裡面的內容複製過去，並根據自己的環境設定變數內容。

使用laradock

本說明會以 nginx mysql redis workspace 的組合安裝環境

建立laradock環境

  1. 克隆此 Laravel-Template並進入 laradock 資料夾
# Clone this repository with submodules
git clone --recurse-submodules https://github.com/Kantai235/Laravel-Template.git

# Enter the repository
cd Laravel-Template

# Enter laradock repository
cd laradock
  1. 你現在應該在Laravel-Template/laradock資料夾，在此建立一個.env 的設定檔案，並將 .env.example 裡面的內容複製過去。
  2. 修改.env的變數 PHP_VERSION=8.1，有其他個人想修改的內容可以自行修改其他變數內容
  3. 運行容器
docker-compose up -d nginx mysql redis workspace

設定Laravel-Template環境變數

  1. 進入workspace容器
# Enter workspace container
docker-compose exec workspace /bin/bash
  1. 你現在應該在workspace container內的/var/www資料夾，在此建立一個 .env 的設定檔案，並將 .env.laradock.example 裡面的內容複製過去。
# Copy .env file
cp .env.laradock.example .env

安裝相依並啟動

composer install
npm install
npm run production
php artisan key:generate
php artisan migrate:refresh --seed
php artisan storage:link
php artisan serve

管理員

Account: [email protected]
Password: secret

使用者

Account: [email protected]
Password: secret

單元測試、檢查程式碼標準

單元測試

./vendor/bin/phpunit tests

檢查程式碼標準

./vendor/bin/phpcs --standard=phpcs.xml