JamesFlare/FlareBlog
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

flarum-queue

Browse Source
This commit is contained in:
JamesFlare1212
2024-10-25 13:30:59 -04:00
parent 7222828595
commit 637bdeb6c0
7 changed files with 229 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
README.md
View File

@@ -14,8 +14,8 @@ Then, install Hugo.
For Linux: For Linux:
```bash ```bash
wget https://github.com/gohugoio/hugo/releases/download/v0.122.0/hugo_extended_0.122.0_linux-amd64.deb wget https://github.com/gohugoio/hugo/releases/download/v0.136.5/hugo_extended_0.136.5_linux-amd64.deb
dpkg -i hugo_extended_0.122.0_linux-amd64.deb dpkg -i hugo_extended_0.136.5_linux-amd64.deb
``` ```
For MacOS: For MacOS:

5
content/en/posts/csci-1100/hw-4/index.md
View File

@@ -154,11 +154,6 @@ Input key words and state abbreviations may be typed in upper or lower case and
### hw4_part1.py ### hw4_part1.py
```python ```python
"""
This script is used to test password strength based on certain criteria.
Author: Jinshan Zhou
"""
import hw4_util import hw4_util
if __name__ == "__main__": if __name__ == "__main__":

5
content/en/posts/csci-1100/hw-6/index.md
View File

@@ -230,10 +230,7 @@ All of these are available full-text on-line. See poetryfoundation.org and learn
### hw6_sol.py ### hw6_sol.py
```python ```python
""" # Debugging
This is a implement of the homework 6 solution for CSCI-1100
"""
#work_dir = "/mnt/c/Users/james/OneDrive/RPI/Spring 2024/CSCI-1100/Homeworks/HW6/hw6_files/" #work_dir = "/mnt/c/Users/james/OneDrive/RPI/Spring 2024/CSCI-1100/Homeworks/HW6/hw6_files/"
work_dir = "" work_dir = ""
stop_word = "stop.txt" stop_word = "stop.txt"

113
content/en/posts/docker-compose/flarum-queue/index.md Normal file
View File

@@ -0,0 +1,113 @@
---
title: Fix the Issue of Flarum Emails Not Being Sent Due to Queue.
subtitle:
date: 2024-10-25T12:30:55-04:00
slug: flarum-queue
draft: false
author:
name: James
link: https://www.jamesflare.com
email:
avatar: /site-logo.avif
description: This blog post addresses an issue with Flarum's email delivery, caused by improper Queue handling. It provides solutions using Docker commands and a Flarum plugin to ensure emails are sent correctly, especially when running Flarum in a Docker container.
keywords:
license:
comment: true
weight: 0
tags:
- Docker
- Flarum
- PHP
- Open Source
categories:
- Tutorials
- Sharing
collections:
- Docker Compose
hiddenFromHomePage: false
hiddenFromSearch: false
hiddenFromRss: false
hiddenFromRelated: false
summary: This blog post addresses an issue with Flarum's email delivery, caused by improper Queue handling. It provides solutions using Docker commands and a Flarum plugin to ensure emails are sent correctly, especially when running Flarum in a Docker container.
resources:
- name: featured-image
src: featured-image.jpg
- name: featured-image-preview
src: featured-image-preview.jpg
toc: true
math: false
lightgallery: false
password:
message:
repost:
enable: false
url:
# See details front matter: https://fixit.lruihao.cn/documentation/content-management/introduction/#front-matter
---
<!--more-->
## Introduction
Recently, while configuring Flarum, I encountered a peculiar issue where users were not receiving emails despite the Email SMTP configuration being correct. This included, but was not limited to, registration activation, password recovery, notifications, etc.
## Cause of the Issue
After searching through the sending logs, I discovered that this problem did not exist a few months ago. Reviewing my recent operations and community feedback, I narrowed the issue down to the Queue. In [Redis sessions, cache & queues](https://discuss.flarum.org/d/21873-redis-sessions-cache-queues), there is mention of the Queue. I overlooked this when initially using Redis.
## Solution
One approach is to execute `php flarum queue:work`, as suggested. However, this command opens an uninterrupted window, and we can use a process guardian to ensure it runs correctly. My Flarum instance runs in a Docker container, which is inconvenient for me. Nevertheless, we can run it first to see if it resolves the email sending issue.
```bash
docker exec flarum /bin/sh -c "cd /flarum/app && php flarum schedule:run"
```
I observed that emails were sent correctly after execution, confirming that the issue was due to the Queue not running properly.
The second method, which I ultimately adopted, involves a small plugin provided by [Database Queue - the simplest queue, even for shared hosting](https://discuss.flarum.org/d/28151-database-queue-the-simplest-queue-even-for-shared-hosting). This plugin uses Cron tasks to handle the Queue, requiring only that Cron runs normally.
To install the plugin, since I am in a Docker container, I reconstructed the command:
```bash
docker exec flarum /bin/sh -c "cd /flarum/app && composer require blomstra/database-queue:*"
```
`flarum` is the name of my container; you can modify it accordingly.
Then, restart Flarum and check if Cron has been correctly added. You should see something similar to:
```bash
root@debain:~# docker exec flarum /bin/sh -c "cd /flarum/app && php flarum schedule:list"
+-------------------------------------------------------+-----------+---------------------------------------------------------------------------------------------------------------------+----------------------------+
| Command | Interval | Description | Next Due |
+-------------------------------------------------------+-----------+---------------------------------------------------------------------------------------------------------------------+----------------------------+
| '/usr/bin/php8' 'flarum' drafts:publish | * * * * * | Publish all scheduled drafts. | 2024-10-25 17:00:00 +00:00 |
| '/usr/bin/php8' 'flarum' fof:best-answer:notify | 0 * * * * | After a configurable number of days, notifies OP of discussions with no post selected as best answer to select one. | 2024-10-25 17:00:00 +00:00 |
| '/usr/bin/php8' 'flarum' queue:work --stop-when-empty | * * * * * | | 2024-10-25 17:00:00 +00:00 |
+-------------------------------------------------------+-----------+---------------------------------------------------------------------------------------------------------------------+----------------------------+
```
`'/usr/bin/php8' 'flarum' queue:work --stop-when-empty` is what we expect, indicating no issues.
Remember to add Cron if you haven't already. You can refer to my example. First, enter crontab:
```bash
crontab -e
```
Add:
```bash
* * * * * /usr/bin/docker exec flarum /bin/sh -c "cd /flarum/app && php flarum schedule:run" >> /dev/null 2>&1
```
## Conclusion
Barring any unforeseen circumstances, you should have resolved the issue of emails not being sent. If emails still fail to send, it may be a configuration issue. Ensure the SMTP information is correct before starting and test it.
## References
- [Redis sessions, cache & queues](https://discuss.flarum.org/d/21873-redis-sessions-cache-queues)
- [Database Queue - the simplest queue, even for shared hosting](https://discuss.flarum.org/d/28151-database-queue-the-simplest-queue-even-for-shared-hosting)

5
content/zh-cn/posts/csci-1100/hw-4/index.md
View File

@@ -153,11 +153,6 @@ import hw4_util
### hw4_part1.py ### hw4_part1.py
```python ```python
"""
This script is used to test password strength based on certain criteria.
Author: Jinshan Zhou
"""
import hw4_util import hw4_util
if __name__ == "__main__": if __name__ == "__main__":

5
content/zh-cn/posts/csci-1100/hw-6/index.md
View File

@@ -191,10 +191,7 @@ $$
### hw6_sol.py ### hw6_sol.py
```python ```python
""" # Debugging
This is a implement of the homework 6 solution for CSCI-1100
"""
#work_dir = "/mnt/c/Users/james/OneDrive/RPI/Spring 2024/CSCI-1100/Homeworks/HW6/hw6_files/" #work_dir = "/mnt/c/Users/james/OneDrive/RPI/Spring 2024/CSCI-1100/Homeworks/HW6/hw6_files/"
work_dir = "" work_dir = ""
stop_word = "stop.txt" stop_word = "stop.txt"

112
content/zh-cn/posts/docker-compose/flarum-queue/index.md Normal file
View File

@@ -0,0 +1,112 @@
---
title: 修正因 Queue 导致的 Flarum 的邮件无法发送问题
subtitle:
date: 2024-10-25T12:30:55-04:00
slug: flarum-queue
draft: false
author:
name: James
link: https://www.jamesflare.com
email:
avatar: /site-logo.avif
description: 本博客文章讨论了Flarum邮件发送的问题，该问题是由于不当的队列处理造成的。它提供了使用Docker命令和一个Flarum插件的解决方案，以确保电子邮件正确发送，尤其是在Docker容器中运行Flarum时。
keywords:
license:
comment: true
weight: 0
tags:
- Docker
- Flarum
- PHP
- 开源软件
categories:
- 教程
collections:
- Docker Compose
hiddenFromHomePage: false
hiddenFromSearch: false
hiddenFromRss: false
hiddenFromRelated: false
summary: 本博客文章讨论了Flarum邮件发送的问题，该问题是由于不当的队列处理造成的。它提供了使用Docker命令和一个Flarum插件的解决方案，以确保电子邮件正确发送，尤其是在Docker容器中运行Flarum时。
resources:
- name: featured-image
src: featured-image.jpg
- name: featured-image-preview
src: featured-image-preview.jpg
toc: true
math: false
lightgallery: false
password:
message:
repost:
enable: false
url:
# See details front matter: https://fixit.lruihao.cn/documentation/content-management/introduction/#front-matter
---
<!--more-->
## 前言
最近在配置 Flarum 的时候碰见一件怪事，那就是 Email SMTP 配置正确的情况下，用户收不到邮件。包括但不限于，注册激活，忘记密码，通知等等。
## 故障原因
经过对发件日志的搜寻，我发现这个问题在几个月前并不存在，复盘我这几个里的操作和社区的反馈，我把问题锁定在了，Queue 上。在 [Redis sessions, cache & queues](https://discuss.flarum.org/d/21873-redis-sessions-cache-queues) 里有提到 Queue。我当初使用 Redis 的时候没注意这行话。
## 解决方案
一种办法就是如它所说，执行 `php flarum queue:work`。但是这个命令会开启一个不中断的窗口，我们可以开一个进程守护之类的东西去确保它正确执行。不过我的 Flarum 实例运行在 Docker 容器里，这对我来说不太方便。不过我们可以先跑一下，看看是不是这个问题导致的邮件无法发送。
```bash
docker exec flarum /bin/sh -c "cd /flarum/app && php flarum schedule:run"
```
我观察到执行后邮件正确发送了，那么就证实问题是 Queue 没正确执行导致的了。
第二种办法也是我最终采用的，[Database Queue - the simplest queue, even for shared hosting](https://discuss.flarum.org/d/28151-database-queue-the-simplest-queue-even-for-shared-hosting) 提供了一个小插件来解决这个问题，它利用 Cron 任务来处理 Queue。这样的话我们只需要确保 Cron 正常执行就行了。
安装插件，我这里因为在 Docker 容器里，所以我重新构造一下命令
```bash
docker exec flarum /bin/sh -c "cd /flarum/app && composer require blomstra/database-queue:*"
```
`flarum` 是我的容器名，你可以参考一下改成你的。
然后重启一下 Flarum，查看一下 Cron 里有没有正确添加，你应该得到类似的东西
```bash
root@debain:~# docker exec flarum /bin/sh -c "cd /flarum/app && php flarum schedule:list"
+-------------------------------------------------------+-----------+---------------------------------------------------------------------------------------------------------------------+----------------------------+
| Command | Interval | Description | Next Due |
+-------------------------------------------------------+-----------+---------------------------------------------------------------------------------------------------------------------+----------------------------+
| '/usr/bin/php8' 'flarum' drafts:publish | * * * * * | Publish all scheduled drafts. | 2024-10-25 17:00:00 +00:00 |
| '/usr/bin/php8' 'flarum' fof:best-answer:notify | 0 * * * * | After a configurable number of days, notifies OP of discussions with no post selected as best answer to select one. | 2024-10-25 17:00:00 +00:00 |
| '/usr/bin/php8' 'flarum' queue:work --stop-when-empty | * * * * * | | 2024-10-25 17:00:00 +00:00 |
+-------------------------------------------------------+-----------+---------------------------------------------------------------------------------------------------------------------+----------------------------+
```
`'/usr/bin/php8' 'flarum' queue:work --stop-when-empty` 就是我们期望的东西，看样子没问题了。
不过记得添加 Cron，如果你没有添加的话，那可以参考我的。首先进入 crontab
```bash
crontab -e
```
添加
```bash
* * * * * /usr/bin/docker exec flarum /bin/sh -c "cd /flarum/app && php flarum schedule:run" >> /dev/null 2>&1
```
## 结尾
不出意外，你已经解决了邮件发不出去的问题。如果邮件还是发不出去，那可能是配置问题，在开始前最好确保 SMTP 信息是正确的，同时测试一下。
## 参考资料
- [Redis sessions, cache & queues](https://discuss.flarum.org/d/21873-redis-sessions-cache-queues)
- [Database Queue - the simplest queue, even for shared hosting](https://discuss.flarum.org/d/28151-database-queue-the-simplest-queue-even-for-shared-hosting)