ims-laravel-admin-starter
เป็นแผงผู้ดูแลระบบที่ได้รับการปรับปรุงและแอปพลิเคชันเริ่มต้น API ที่สร้างขึ้นโดยใช้เฟรมเวิร์ก Laravel 10 อันทรงพลังและ Filment 3
เป้าหมายหลักของเราคือการมอบโครงการเริ่มต้นการพัฒนาในท้องถิ่นที่ไม่ยุ่งยากและพร้อมใช้งานให้กับคุณ
โปรเจ็กต์นี้แตกต่างจากตัวสร้าง API หรือตัวสร้างโค้ดแบบดั้งเดิม ทำให้กระบวนการตั้งค่าสภาพแวดล้อมการพัฒนาในเครื่องของคุณง่ายขึ้น ช่วยให้คุณสามารถเริ่มต้นการพัฒนา API ที่ใช้ Laravel และการพัฒนาแผงผู้ดูแลระบบได้อย่างรวดเร็วโดยไม่มีความซับซ้อนที่ไม่จำเป็น สิ่งนี้ช่วยให้คุณมุ่งเน้นไปที่การสร้างตรรกะของแอปพลิเคชันของคุณ แทนที่จะใช้เวลากับการตั้งค่าเริ่มต้น
ระบบการตรวจสอบความถูกต้องเต็มรูปแบบ : ใช้ระบบการตรวจสอบความถูกต้องที่มีประสิทธิภาพโดยใช้แพ็คเกจ Laravel Jetstream เพื่อการจัดการผู้ใช้และฟังก์ชันการเข้าสู่ระบบที่ปลอดภัย
ระบบการอนุญาตตามบทบาทและการอนุญาต : สร้างระบบการอนุญาตที่ยืดหยุ่นโดยใช้แพ็คเกจ Laravel-Permission ช่วยให้คุณสามารถกำหนดบทบาทและการอนุญาตสำหรับการควบคุมการเข้าถึงแบบละเอียด
การจัดการผู้ใช้ : จัดการผู้ใช้อย่างมีประสิทธิภาพ รวมถึงการลงทะเบียนผู้ใช้ การอัพเดตโปรไฟล์ และบทบาทของผู้ใช้
การตั้งค่าโปรไฟล์ : อนุญาตให้ผู้ใช้ปรับแต่งโปรไฟล์ของตน รวมถึงข้อมูลส่วนบุคคลและการตั้งค่า
การสนับสนุนหลายภาษา : ทำให้แอปพลิเคชันของคุณเข้าถึงได้สำหรับผู้ชมทั่วโลกด้วยความช่วยเหลือของ Filament Translations และแพ็คเกจ Laravel Lang สำหรับการรองรับหลายภาษา
การปรับแต่งธีม : ปรับแต่งรูปลักษณ์ของแอปพลิเคชันและอินเทอร์เฟซผู้ใช้โดยใช้พลังของ Tailwind CSS เพื่อสร้างการออกแบบที่ดึงดูดสายตา
การสนับสนุน Docker : ปรับใช้และจัดการแอปพลิเคชันของคุณในคอนเทนเนอร์ Docker ได้อย่างง่ายดายด้วยความสะดวกสบายของ Laravel Sail เพื่อการพัฒนาและเวิร์กโฟลว์การปรับใช้ที่มีประสิทธิภาพ
เลือกเครื่องมือการพัฒนาท้องถิ่นของคุณ:
เลือกเครื่องมือการพัฒนาในพื้นที่ที่คุณต้องการ เช่น Laragon, XAMPP, WAMP หรือเครื่องมืออื่นๆ ที่เหมาะกับความต้องการของคุณ
กำหนดค่าสภาพแวดล้อมของคุณ:
อัปเดตไฟล์ .env
ของคุณด้วยข้อมูลรับรองฐานข้อมูลที่ถูกต้อง
ติดตั้งการพึ่งพา:
รันคำสั่งต่อไปนี้เพื่อติดตั้งการขึ้นต่อกันที่จำเป็นโดยใช้ Composer:
composer install
รันคำสั่งต่อไปนี้เพื่อติดตั้งการขึ้นต่อกันที่จำเป็นโดยใช้ npm และสร้างมันขึ้นมา:
npm install
npm run build
โยกย้ายและเริ่มต้นฐานข้อมูล: เริ่มต้นและเริ่มต้นฐานข้อมูลด้วยข้อมูลเริ่มต้นโดยใช้:
php artisan migrate --seed
ตอนนี้โครงการของคุณพร้อมใช้งานแล้ว คุณสามารถเข้าถึงแผงผู้ดูแลระบบผ่านเส้นทางที่ให้ไว้ หากคุณได้รันคำสั่ง seed ให้เข้าสู่ระบบด้วยข้อมูลประจำตัวที่ให้ไว้ ปรับแต่งและขยายแอปพลิเคชันของคุณตามต้องการ
เมื่อคุณตั้งค่าโครงการโดยใช้คำแนะนำที่ให้ไว้ คุณสามารถเข้าถึงแผงผู้ดูแลระบบได้โดยไปที่เส้นทาง /admin
บนเว็บเบราว์เซอร์ของคุณ
หากคุณได้รันคำสั่ง seed ในระหว่างขั้นตอนการตั้งค่า คุณสามารถเข้าสู่ระบบโดยใช้ข้อมูลประจำตัวต่อไปนี้:
email: [email protected]
password: 123456
email: [email protected]
password: 123456
ims-laravel-admin-starter
รองรับการดำเนินการตามบทบาทและการอนุญาตเพื่อควบคุมการเข้าถึงฟังก์ชันต่างๆ ภายในแผงผู้ดูแลระบบของคุณ คุณสามารถกำหนดบทบาทด้วยสิทธิ์เฉพาะและมอบหมายให้กับผู้ใช้ได้ตามต้องการ
สำรวจโปรเจ็กต์นี้และสัมผัสกับความสะดวกสบายของสภาพแวดล้อมการพัฒนาท้องถิ่นที่พร้อมใช้งานสำหรับ API ที่ใช้ Laravel และแผงผู้ดูแลระบบของคุณ
ยกระดับการเข้าถึงและความเป็นมิตรต่อผู้ใช้ของโครงการเริ่มต้นนี้ด้วยการรองรับหลายภาษา ด้วยความช่วยเหลือของ Filament Translations และแพ็คเกจ Laravel Lang โครงการเริ่มต้นนี้จึงให้การสนับสนุนหลายภาษาอย่างครอบคลุม
สำหรับคำแนะนำโดยละเอียดเกี่ยวกับการทำงานกับหลายภาษาและการแปล โปรดไปที่หน้าวิกิเฉพาะของเรา
ปลดล็อกโลกแห่งความเป็นไปได้ด้วยการแปลภาษาอย่างราบรื่น เพื่อให้มั่นใจว่าแอปพลิเคชันของคุณโดนใจผู้ชมทั่วโลก
สำหรับคำแนะนำที่ครอบคลุมมากขึ้น โปรดไปที่หน้า WIKI บน GitHub:
การรันแอปพลิเคชันด้วย Docker และ Laravel Sail - Wiki
ทรัพยากรโดยละเอียดนี้ให้คำแนะนำทีละขั้นตอนและข้อมูลเพิ่มเติมเพื่อให้แน่ใจว่าได้รับประสบการณ์ที่ราบรื่นเมื่อตั้งค่าและรันแอปพลิเคชันของคุณด้วย Docker และ Laravel Sail
เพื่อให้มั่นใจในความน่าเชื่อถือและความถูกต้องของแอปพลิเคชันของคุณ การดำเนินการทดสอบจึงเป็นสิ่งสำคัญ ทำตามขั้นตอนง่ายๆ เหล่านี้:
สร้างฐานข้อมูลทดสอบแยกต่างหาก:
เริ่มต้นด้วยการสร้างฐานข้อมูลทดสอบเฉพาะสำหรับแอปพลิเคชันของคุณ คุณสามารถตั้งชื่อว่า ims-admin-testing
เพื่อให้แตกต่างจากฐานข้อมูลที่ใช้งานจริงของคุณ
หากคุณใช้ Docker และ Laravel Sail คุณสามารถข้ามขั้นตอนนี้และอัปเดตไฟล์ phpunit.xml เพื่อเพิ่มฐานข้อมูลการทดสอบแทน:
< env name = " DB_DATABASE " value = " testing " />
รันการทดสอบ:
คุณมีสองตัวเลือกที่สะดวกสำหรับการรันการทดสอบ:
การใช้ศัตรูพืช:
ดำเนินการทดสอบด้วย Pest ซึ่งเป็นเฟรมเวิร์กการทดสอบ PHP ที่สวยงาม เพียงรันคำสั่งต่อไปนี้:
./vendor/bin/pest
หากคุณใช้งาน Sail คุณสามารถใช้คำสั่งนี้:
./vendor/bin/sail test
# or if you have an alias configured:
sail test
ใช้ช่าง:
เครื่องมือบรรทัดคำสั่ง Artisan ของ Laravel มอบความสามารถในการทดสอบที่ราบรื่น รันการทดสอบด้วยคำสั่ง Artisan ต่อไปนี้:
php artisan test
หากคุณใช้งาน Sail คุณสามารถใช้คำสั่งนี้:
./vendor/bin/sail artisan test
# or if you have an alias configured:
sail artisan test
การรันการทดสอบถือเป็นสิ่งสำคัญเพื่อให้มั่นใจถึงความน่าเชื่อถือและความถูกต้องของฟังก์ชันการทำงานของแอปพลิเคชันของคุณ คำสั่งข้างต้นจะเริ่มกระบวนการทดสอบและให้ข้อมูลเชิงลึกอันมีค่าเกี่ยวกับคุณภาพของโค้ดเบสของคุณ
เคล็ดลับประสิทธิภาพบางประการสำหรับเส้นใย
เพื่อเพิ่มประสิทธิภาพการทำงานของแอป Filament คุณสามารถใช้คำสั่ง php artisan icons:cache
เพื่อแคชไอคอนได้ คำสั่งนี้จะโหลดและแคชไอคอนที่ใช้ในแอปพลิเคชันของคุณล่วงหน้า ส่งผลให้เวลาในการโหลดเร็วขึ้น
php artisan icons:cache
หากคุณประสบปัญหาด้านประสิทธิภาพและต้องการเพิ่มความเร็วให้กับแอปพลิเคชันของคุณ ให้พิจารณาปิดการใช้งานคุณลักษณะการรวบรวมมุมมองใน Debugbar ต่อไปนี้คือวิธีที่คุณสามารถทำได้:
ไปที่ไฟล์การกำหนดค่า debugbar.php
ที่อยู่ในไดเร็กทอรี config
ของแอปของคุณ
ภายในไฟล์ debugbar.php
คุณจะพบอาร์เรย์ชื่อ collectors
ค้นหาตัวรวบรวม 'views'
ภายในอาร์เรย์นี้
หากต้องการปิดการใช้งานคอลเลกชันมุมมอง เพียงตั้งค่าตัวรวบรวม 'views'
เป็น false
เช่นนี้:
' collectors ' => [
...
' views ' => false, // Views with their data
],
การเปลี่ยนแปลงนี้จะป้องกันไม่ให้ Debugbar รวบรวมและแสดงข้อมูลมุมมอง ซึ่งสามารถช่วยปรับปรุงประสิทธิภาพของแอปพลิเคชันของคุณ โดยเฉพาะในสภาพแวดล้อมการพัฒนา
โปรเจ็กต์นี้มีคำสั่ง Artisan เพิ่มเติมเพื่อทำให้เวิร์กโฟลว์ของคุณง่ายขึ้นและเพิ่มผลผลิต
สร้างไฟล์ตัวช่วย IDE ทั่วไปเพื่อการเติมโค้ดอัตโนมัติและการนำทางที่ดีขึ้นโดยการรัน:
php artisan ide-helper:generate
สร้างไฟล์ตัวช่วยโมเดล IDE โดยไม่ต้องเขียนลงในไฟล์โมเดลโดยใช้:
# use any one of this two commands
php artisan ide-helper:models -N
php artisan ide-helper:models --nowrite
php artisan csfixer:run
คำสั่งนี้ช่วยให้แน่ใจว่าโค้ดของคุณเป็นไปตามมาตรฐานการเข้ารหัสที่กำหนดไว้ล่วงหน้า ทำให้โค้ดเบสของคุณสะอาดและอ่านง่าย
การสร้างบริการสำหรับแอปพลิเคชันของคุณทำได้อย่างง่ายดาย ใช้คำสั่งต่อไปนี้เพื่อสร้างบริการ:
php artisan make:service subfolder/ServiceName
แทนที่โฟลเดอร์ย่อยและ ServiceName ด้วยค่าจริงที่คุณต้องการ คุณสามารถสร้างบริการโดยไม่มีโฟลเดอร์ย่อยได้:
php artisan make:service TestService
บริการที่สร้างขึ้นใหม่จะอยู่ที่ app/Http/Services/TestService.php
พร้อมที่จะจัดการตรรกะทางธุรกิจของแอปพลิเคชันของคุณ
ลักษณะเป็นส่วนประกอบของโค้ดที่นำมาใช้ซ้ำได้ซึ่งช่วยปรับปรุงการจัดระเบียบโค้ด หากต้องการสร้างลักษณะใหม่ เพียงเรียกใช้:
php artisan make:trait TestTrait
คำสั่งนี้สร้างไฟล์ลักษณะใหม่สำหรับโปรเจ็กต์ของคุณ ส่งเสริมการนำโค้ดกลับมาใช้ใหม่และการบำรุงรักษา
ใช้ประโยชน์จากคำสั่ง Artisan เหล่านี้เพื่อปรับปรุงกระบวนการพัฒนาของคุณและรักษาฐานโค้ดที่มีโครงสร้างที่ดี
โปรเจ็กต์นี้นำเสนอโดย Innovix Matrix System และเผยแพร่เป็นซอฟต์แวร์โอเพ่นซอร์สภายใต้ใบอนุญาต MIT
รู้สึกอิสระที่จะใช้ แก้ไข และแจกจ่ายโปรเจ็กต์เริ่มต้นนี้ตามเงื่อนไขสิทธิ์การใช้งาน MIT เราสนับสนุนการทำงานร่วมกันและยินดีรับการสนับสนุนจากชุมชนเพื่อทำให้โครงการนี้ดียิ่งขึ้น