minimal blog

บล็อกขั้นต่ำ

Minimal Blog เป็นบล็อกเรียบง่ายที่ออกแบบด้วยอินเทอร์เฟซที่เรียบง่าย ผู้ใช้สามารถย้ายไปอยู่ในหมวดหมู่ อ่านบทความ และโต้ตอบกับผู้เขียนผ่านทางส่วนความคิดเห็น ผู้เขียนบล็อกสามารถควบคุมเนื้อหาทั้งหมดได้อย่างสมบูรณ์ผ่านแดชบอร์ดผู้ดูแลระบบที่ปลอดภัย

---

โปรเจ็กต์นี้สร้างขึ้นเพื่อแสดงทักษะบางอย่างของฉันเช่น:

• การบูรณาการขั้นพื้นฐานกับองค์ประกอบ TailwindCSS
• CRUD ในหมวดหมู่ โพสต์ ความคิดเห็น จดหมายข่าว
• การรักษาความปลอดภัย (การรับรองความถูกต้อง การอนุญาต ผู้มีสิทธิเลือกตั้ง)
• องค์ประกอบทางศุลกากร (บริการ slugifier, การขยายกิ่งไม้สำหรับวันที่, เครื่องมือตรวจสอบ, เครื่องมือสร้างแบบสอบถาม...)
• เลขหน้าหลักคำสอน
• ข้อความ Async (อีเมลจดหมายข่าว) ด้วย Messenger และ RabbitMQ ผ่าน Docker
• การทดสอบครอบคลุม (การทดสอบหน่วยและฟังก์ชัน) ด้วย PHPUnit

เริ่มต้นเลย

ข้อกำหนดเบื้องต้น

• PHP 8.1 หรือสูงกว่า (Symfony 6.1)
• ผู้แต่ง
• เส้นด้าย / NodeJS
• นักเทียบท่า

ติดตั้ง

1. โคลนโครงการนี้
2. ติดตั้งการพึ่งพาด้วย composer install และ yarn install
3. สร้าง .env.local ของคุณและเพิ่ม DSN ฐานข้อมูลของคุณเอง
4. สร้างฐานข้อมูล ใช้การย้ายข้อมูล และเติมด้วยฟิกซ์เจอร์ : bin/console doctrine:database:create bin/console doctrine:migrations:migrate bin/console doctrine:fixtures:load

การทำงาน

1. เรียกใช้ docker-compose up เพื่อเริ่มอิมเมจ Docker (mailcatcher และเซิร์ฟเวอร์ RabbitMQ)
2. แก้ไข .env.local ของคุณโดยอัปเดต RABBITMQ_DSN และ MAILER_DSN คุณสามารถค้นหาได้ด้วยการเรียกใช้ : symfony var:export --multiline | grep 'MAILER_DSN|RABBITMQ_DSN'
3. รัน yarn run dev --watch เพื่อเปิดเซิร์ฟเวอร์ในเครื่องของคุณสำหรับสินทรัพย์
4. เรียกใช้ symfony serve เพื่อเปิดใช้งานเว็บเซิร์ฟเวอร์ php ในพื้นที่ของคุณ
5. เสร็จแล้ว ! ตรวจสอบเซิร์ฟเวอร์ localhost ของคุณ: http://127.0.0.1:8000/

ใช้ข้อความอะซิงโครนัส

1. เรียกใช้ symfony open:local:rabbitmq และ symfony open:local:webmail เพื่อเริ่มเซิร์ฟเวอร์ RabbitMQ และ web mailcatcher
2. เข้าสู่ระบบ RabbitMQ ด้วยข้อมูลรับรอง : guest:guest
3. หากต้องการส่งข้อความถึง RabbitMQ ให้เข้าสู่ระบบในฐานะผู้ดูแลระบบ ( [email protected]:admin ) จากนั้นไปที่แดชบอร์ดผู้ดูแลระบบและคลิกที่ "จดหมายข่าว" คุณจะเห็นปุ่ม "ส่ง" โดยระบบจะส่งข้อความ 1 ข้อความต่อสมาชิกถึง จดหมายข่าว (ค่าเริ่มต้น 50)
4. เรียกใช้ bin/console messenger:consume -vv async เพื่อใช้ข้อความใน RabbitMQ ข้อความเหล่านั้นจะถูกส่งและแสดงใน Mailcatcher อย่างต่อเนื่อง

การทดสอบ

ตามค่าเริ่มต้น การทดสอบทั้งหมดจะใช้ได้กับฟิกซ์เจอร์ ดังนั้นอย่าลืมโหลดมัน !

1. อัปเดต .env.test ของคุณและเพิ่ม DSN ฐานข้อมูลทดสอบของคุณ
2. สร้างฐานข้อมูล ใช้การย้ายข้อมูล และเติมด้วยฟิกซ์เจอร์ : bin/console doctrine:database:create --env=test bin/console doctrine:migrations:migrate --env=test bin/console doctrine:fixtures:load --env=test
3. เรียกใช้ bin/phpunit เพื่อเปิดการทดสอบแบตเตอรี่

สร้างด้วย

• ซิมโฟนี 6.1
• MySQL
• TailwindCSS (ธีมลมผี)
• นักเทียบท่า
• RabbitMQ
• PHPUnit