minimal blog

最小的博客

Minimal Blog 是一個簡單的博客，採用簡約的介面設計。用戶可以進入類別、閱讀文章並透過評論部分與作者互動。部落格的作者可以透過安全的管理儀表板完全控制每個內容。

---

創建這個專案是為了展示我的一些技能，例如：

• 與 TailwindCSS 元素的基本集成
• 對類別、貼文、評論、時事通訊進行 CRUD
• 安全性（身份驗證、授權、投票）
• 海關元素（slugifier 服務、日期的樹枝擴充、驗證器、查詢建構器...）
• 教義分頁器
• 透過 Docker 使用 Messenger 和 RabbitMQ 進行非同步訊息（時事通訊電子郵件）
• 使用 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. 透過更新RABBITMQ_DSN和MAILER_DSN編輯您的.env.local ，您可以透過運行找到它們： symfony var:export --multiline | grep 'MAILER_DSN|RABBITMQ_DSN'
3. 執行yarn run dev --watch來啟動資產的本機伺服器
4. 運行symfony serve來啟動本機 php Web 伺服器
5. 完畢 ！檢查您的本機主機伺服器： http://127.0.0.1:8000/ ://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/ bin/console doctrine:migrations:migrate --env=test bin/console doctrine:fixtures:load --env=test
3. 運行bin/phpunit來啟動一系列測試

內建

• 交響樂6.1
• MySQL
• TailwindCSS（幽靈風主題）
• 碼頭工人
• RabbitMQ
• PHP單元