Skip to content

Commit 5b18a00

Browse files
committed
Fix some typos + update README.
1 parent fb77d15 commit 5b18a00

File tree

5 files changed

+21
-13
lines changed

5 files changed

+21
-13
lines changed

README.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
## **What is phpMussel?**
88

9-
An ideal solution for shared hosting environments, where it's often not possible to utilise or install conventional anti-virus protection solutions, phpMussel is a PHP script designed to **detect trojans, viruses, malware and other threats** within files uploaded to your system wherever the script is hooked, based on the signatures of [ClamAV](https://www.clamav.net/) and others. For information regarding *HOW TO INSTALL* {2A+2B} and *HOW TO USE* {3A+3B} phpMussel, please refer either to the [Wiki](https://github.com/phpMussel/phpMussel/wiki) or to the [documentation](https://github.com/phpMussel/Docs/tree/master) (direct links to that documentation included under the "Documentation" header below this paragraph).
9+
An ideal solution for shared hosting environments, where it's often not possible to utilise or install conventional anti-virus protection solutions, phpMussel is a PHP script designed to **detect trojans, viruses, malware and other threats** within files uploaded to your system wherever the script is hooked, based on the signatures of [ClamAV](https://www.clamav.net/) and others. For information regarding *HOW TO INSTALL* and *HOW TO USE* phpMussel, please refer either to the [Wiki](https://github.com/phpMussel/phpMussel/wiki) or to the [documentation](https://github.com/phpMussel/Docs/tree/master) (direct links to that documentation included under the "Documentation" header below this paragraph).
1010

1111
---
1212

@@ -33,10 +33,18 @@ $Loader = new \phpMussel\Core\Loader();
3333
$Scanner = new \phpMussel\Core\Scanner($Loader);
3434
$FrontEnd = new \phpMussel\FrontEnd\FrontEnd($Loader, $Scanner);
3535
$Web = new \phpMussel\Web\Web($Loader, $Scanner);
36+
$Loader->Events->addHandler('sendMail', new \phpMussel\PHPMailer\Linker($Loader));
3637

38+
// Scans file uploads (execution terminates here if the scan finds anything).
3739
$Web->scan();
40+
41+
// Fixes possible corrupted file upload names (Warning: modifies the content of $_FILES).
42+
$Web->demojibakefier();
43+
44+
// Load the front-end.
3845
$FrontEnd->view();
3946

47+
// Cleanup.
4048
unset($Web, $FrontEnd, $Scanner, $Loader);
4149
```
4250

@@ -56,4 +64,4 @@ __*Screenshot:*__
5664
---
5765

5866

59-
Last Updated: 6 July 2020 (2020.07.06).
67+
Last Updated: 20 July 2020 (2020.07.20).

l10n/ru.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
# License: GNU/GPLv2
88
# @see LICENSE.txt
99
#
10-
# This file: Russian language data (last modified: 2020.07.16).
10+
# This file: Russian language data (last modified: 2020.07.18).
1111
##/
1212

1313
config_core: "Общая конфигурация (любая конфигурация ядра, не относящаяся к другим категориям)."
@@ -177,7 +177,7 @@ label_upload_origin: "Происхождение загрузки: "
177177
label_upload_size: "Размер загрузки: "
178178
label_your_ip: "Ваш IP:"
179179
label_your_ua: "Ваш UA:"
180-
link_accounts: "Учетными Записями"
180+
link_accounts: "Аккаунта"
181181
link_cache_data: "Данные Кэша"
182182
link_chat: "Чат"
183183
link_config: "Конфигурация"
@@ -262,7 +262,7 @@ state_quarantine:
262262
- "В карантине есть %s файла."
263263
- "В карантине есть %s файлов."
264264
tip_2fa_sent: "На ваш адрес электронной почты отправлено электронное письмо с двухфакторным кодом аутентификации. Пожалуйста, подтвердите этот код ниже, чтобы получить доступ к фронтенд. Если Вы не получили это письмо, попробуйте выйти из системы, ожидая 10 минут, и снова войдите в систему, чтобы получить новое электронное письмо, содержащее новый код."
265-
tip_accounts: "Привет, {username}.<br />Учетными записями страница позволяет контролировать, кто может получить доступ к phpMussel фронтенд."
265+
tip_accounts: "Привет, {username}.<br />Аккаунта страница позволяет контролировать, кто может получить доступ к phpMussel фронтенд."
266266
tip_cache_data: "Привет, {username}.<br />Здесь вы можете просмотреть содержимое кеша."
267267
tip_config: "Привет, {username}.<br />Конфигурация страница позволяет изменять конфигурацию для phpMussel от фронтенд."
268268
tip_fe_cookie_warning: "Заметка: phpMussel использует cookie для аутентификации логинов. Войдя в систему, Вы даете свое согласие на создание и сохранение файла cookie вашим браузером."

l10n/zh-TW.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
# License: GNU/GPLv2
88
# @see LICENSE.txt
99
#
10-
# This file: Chinese (traditional) language data (last modified: 2020.07.16).
10+
# This file: Chinese (traditional) language data (last modified: 2020.07.17).
1111
##/
1212

1313
config_core: "基本配置(任何不屬於其他類別的核心配置)。"
@@ -33,7 +33,7 @@ config_files: "在掃描過程中如何處理文件。"
3333
config_files_allow_leading_trailing_dots: "允許文件名中的前導和尾隨點嗎?​這有時可用於隱藏文件,或欺騙某些系統允許目錄遍歷。​False(假)=不允許【默認】;True(真)=允許。"
3434
config_files_archive_file_extensions: "認可存檔文件擴展(格式是CSV;應該只添加或去掉當問題發生;不必要的去掉可能的可以導致假陽性出現為存檔文件,​而不必要的增加將實質上白名單任何事您增加從專用攻擊檢測;修改有慎重;還請注這個無影響在什麼存檔可以和不能被分析在內容級)。​這個名單,​作為是作為標準,​名單那些格式使用最常見的橫過多數的系統和CMS,​但有意是不全面。"
3535
config_files_block_control_characters: "受阻任何文件包含任何控製字符嗎(以外換行符)?​(<code>[\x00-\x08\x0b\x0c\x0e\x1f\x7f]</code>) 如果您只上傳純文本,​您可以激活這個指令以提供某些另外保護在您的系統。​然而,​如果您上傳任何事以外純文本,​激活這個可能結果在假陽性。​False(假)=不受阻【默認】;True(真)=受阻。"
36-
config_files_block_encrypted_archives: "檢測和受阻加密的存檔嗎?​因為phpMussel是不能夠掃描加密的存檔內容,​它是可能存檔加密可能的可以使用通過一個攻擊者作為一種手段嘗試繞過phpMussel,​殺毒掃描儀和其他這樣的保護。​指示phpMussel受阻任何存檔它發現被加密可能的可以幫助減少任何風險有關聯這些可能性。​False(假)=不受阻;True(真)=受阻【默認】。"
36+
config_files_block_encrypted_archives: "檢測和受阻加密的存檔嗎?​因為phpMussel是不能夠掃描加密的存檔內容,​它是可能存檔加密可能的可以使用通過一個攻擊者作為一種手段嘗試繞過phpMussel,​殺毒掃描程序和其他這樣的保護。​指示phpMussel受阻任何存檔它發現被加密可能的可以幫助減少任何風險有關聯這些可能性。​False(假)=不受阻;True(真)=受阻【默認】。"
3737
config_files_block_macros: "嘗試阻止任何包含宏的文件嗎?​某些文檔和電子表格類型可能包含可執行的宏,因此提供了危險的潛在惡意軟件向量。​False(假)=不阻止【默認】;​True(真)=阻止。"
3838
config_files_can_contain_php_file_extensions: "允許包含PHP代碼的文件擴展名列表,以逗號分隔。​如果啟用了PHP變色龍攻擊檢測,包含PHP代碼的文件,其擴展名不在此列表中,將被檢測為PHP變色龍攻擊。"
3939
config_files_chameleon_from_exe: "尋找可執行頭在文件是不可執行文件也不認可存檔文件和尋找可執行文件誰的頭是不正確。​False(假)=是關閉;True(真)=是激活。"
@@ -54,7 +54,7 @@ config_files_filetype_greylist: "灰名單:"
5454
config_files_filetype_whitelist: "如果您的系統只允許具體文件類型被上傳,​或如果您的系統明確地否認某些文件類型,​指定那些文件類型在白名單,​黑名單和灰名單可以增加掃描執行速度通過允許腳本跳過某些文件類型。​格式是CSV(逗號分隔變量)。​如果您想掃描一切,​而不是白名單,​黑名單或灰名單,​留變量空;這樣做將關閉白名單/黑名單/灰名單。​進程邏輯順序是:如果文件類型已白名單,​不掃描和不受阻文件,​和不匹配文件對照黑名單或灰名單。​如果文件類型已黑名單,​不掃描文件但阻止它無論如何,​和不匹配文件對照灰名單。​如果灰名單是空,​或如果灰名單不空和文件類型已灰名單,​掃描文件像正常和確定如果阻止它基於掃描結果,​但如果灰名單不空和文件類型不灰名單,​過程文件彷彿已黑名單,​因此不掃描它但阻止它無論如何。​白名單:"
5555
config_files_max_files_in_archives: "在中止掃描之前從檔案中掃描的最大文件數。​默認=0(沒有最大文件數)。"
5656
config_files_max_recursion: "最大存檔遞歸深度限。​默認=3。"
57-
config_files_only_allow_images: "設置為true時,掃描儀遇到的任何非圖像文件將被立即標記,而不會被掃描。​在某些情況下,這可能有助於減少完成掃描所需的時間。​默認情況下設置為false。"
57+
config_files_only_allow_images: "設置為true時,掃描程序遇到的任何非圖像文件將被立即標記,而不會被掃描。​在某些情況下,這可能有助於減少完成掃描所需的時間。​默認情況下設置為false。"
5858
config_files_scannable_threshold: "原始數據讀取和掃描的最大長度(如果有任何引人注目性能問題當掃描)。​默認 = 32MB。​零或空值將關閉門檻。​按說,​這個數值應不會少於平均文件大小的文件上傳您想和期待收到您的服務器或網站,​應不會多於<code>filesize_limit</code>指令,​和應不會多於大致五分之一的總允許內存分配獲授PHP通過"php.ini"配置文件。​這個指令存在為嘗試防止phpMussel從用的太多內存(這個將防止它從能夠順利掃描文件以上的一個特別文件大小)。"
5959
config_frontend: "前端的配置。"
6060
config_frontend_default_algo: "定義要用於所有未來密碼和會話的算法。​選項:​PASSWORD_DEFAULT(標準),​PASSWORD_BCRYPT,​PASSWORD_ARGON2I(需要PHP &gt;= 7.2.0),​PASSWORD_ARGON2ID(需要PHP &gt;= 7.3.0)。"

l10n/zh.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
# License: GNU/GPLv2
88
# @see LICENSE.txt
99
#
10-
# This file: Chinese (simplified) language data (last modified: 2020.07.16).
10+
# This file: Chinese (simplified) language data (last modified: 2020.07.17).
1111
##/
1212

1313
config_core: "基本配置(任何不属于其他类别的核心配置)。"
@@ -33,7 +33,7 @@ config_files: "在扫描过程中如何处理文件。"
3333
config_files_allow_leading_trailing_dots: "允许文件名中的前导和尾随点吗?​这有时可用于隐藏文件,或欺骗某些系统允许目录遍历。​False(假)=不允许【默认】;True(真)=允许。"
3434
config_files_archive_file_extensions: "认可存档文件扩展(格式是CSV;应该只添加或去掉当问题发生;不必要的去掉可能的可以导致假阳性出现为存档文件,​而不必要的增加将实质上白名单任何事您增加从专用攻击检测;修改有慎重;还请注这个无影响在什么存档可以和不能被分析在内容级)。​这个名单,​作为是作为标准,​名单那些格式使用最常见的横过多数的系统和CMS,​但有意是不全面。"
3535
config_files_block_control_characters: "受阻任何文件包含任何控制字符吗(以外换行符)?​(<code>[\x00-\x08\x0b\x0c\x0e\x1f\x7f]</code>) 如果您只上传纯文本,​您可以激活这个指令以提供某些另外保护在您的系统。​然而,​如果您上传任何事以外纯文本,​激活这个可能结果在假阳性。​False(假)=不受阻【默认】;True(真)=受阻。"
36-
config_files_block_encrypted_archives: "检测和受阻加密的存档吗?​因为phpMussel是不能够扫描加密的存档内容,​它是可能存档加密可能的可以使用通过一个攻击者作为一种手段尝试绕过phpMussel,​杀毒扫描仪和其他这样的保护。​指示phpMussel受阻任何存档它发现被加密可能的可以帮助减少任何风险有关联这些可能性。​False(假)=不受阻;True(真)=受阻【默认】。"
36+
config_files_block_encrypted_archives: "检测和受阻加密的存档吗?​因为phpMussel是不能够扫描加密的存档内容,​它是可能存档加密可能的可以使用通过一个攻击者作为一种手段尝试绕过phpMussel,​杀毒扫描程序和其他这样的保护。​指示phpMussel受阻任何存档它发现被加密可能的可以帮助减少任何风险有关联这些可能性。​False(假)=不受阻;True(真)=受阻【默认】。"
3737
config_files_block_macros: "尝试阻止任何包含宏的文件吗?​某些文档和电子表格类型可能包含可执行的宏,因此提供了危险的潜在恶意软件向量。​False(假)=不阻止【默认】;​True(真)=阻止。"
3838
config_files_can_contain_php_file_extensions: "允许包含PHP代码的文件扩展名列表,以逗号分隔。​如果启用了PHP变色龙攻击检测,包含PHP代码的文件,其扩展名不在此列表中,将被检测为PHP变色龙攻击。"
3939
config_files_chameleon_from_exe: "寻找可执行头在文件是不可执行文件也不认可存档文件和寻找可执行文件谁的头是不正确。​False(假)=是关闭;True(真)=是激活。"
@@ -54,7 +54,7 @@ config_files_filetype_greylist: "灰名单:"
5454
config_files_filetype_whitelist: "如果您的系统只允许具体文件类型被上传,​或如果您的系统明确地否认某些文件类型,​指定那些文件类型在白名单,​黑名单和灰名单可以增加扫描执行速度通过允许脚本跳过某些文件类型。​格式是CSV(逗号分隔变量)。​如果您想扫描一切,​而不是白名单,​黑名单或灰名单,​留变量空;这样做将关闭白名单/黑名单/灰名单。​进程逻辑顺序是:如果文件类型已白名单,​不扫描和不受阻文件,​和不匹配文件对照黑名单或灰名单。​如果文件类型已黑名单,​不扫描文件但阻止它无论如何,​和不匹配文件对照灰名单。​如果灰名单是空,​或如果灰名单不空和文件类型已灰名单,​扫描文件像正常和确定如果阻止它基于扫描结果,​但如果灰名单不空和文件类型不灰名单,​过程文件仿佛已黑名单,​因此不扫描它但阻止它无论如何。​白名单:"
5555
config_files_max_files_in_archives: "在中止扫描之前从档案中扫描的最大文件数。​默认=0(没有最大文件数)。"
5656
config_files_max_recursion: "最大存档递归深度限。​默认=3。"
57-
config_files_only_allow_images: "设置为true时,扫描仪遇到的任何非图像文件将被立即标记,而不会被扫描。​在某些情况下,这可能有助于减少完成扫描所需的时间。​默认情况下设置为false。"
57+
config_files_only_allow_images: "设置为true时,扫描程序遇到的任何非图像文件将被立即标记,而不会被扫描。​在某些情况下,这可能有助于减少完成扫描所需的时间。​默认情况下设置为false。"
5858
config_files_scannable_threshold: "原始数据读取和扫描的最大长度(如果有任何引人注目性能问题当扫描)。​默认 = 32MB。​零或空值将关闭门槛。​按说,​这个数值应不会少于平均文件大小的文件上传您想和期待收到您的服务器或网站,​应不会多于<code>filesize_limit</code>指令,​和应不会多于大致五分之一的总允许内存分配获授PHP通过"php.ini"配置文件。​这个指令存在为尝试防止phpMussel从用的太多内存(这个将防止它从能够顺利扫描文件以上的一个特别文件大小)。"
5959
config_frontend: "前端的配置。"
6060
config_frontend_default_algo: "定义要用于所有未来密码和会话的算法。​选项:​PASSWORD_DEFAULT(标准),​PASSWORD_BCRYPT,​PASSWORD_ARGON2I(需要PHP &gt;= 7.2.0),​PASSWORD_ARGON2ID(需要PHP &gt;= 7.3.0)。"

src/FrontEnd.php

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
* License: GNU/GPLv2
99
* @see LICENSE.txt
1010
*
11-
* This file: Front-end handler (last modified: 2020.07.15).
11+
* This file: Front-end handler (last modified: 2020.07.19).
1212
*/
1313

1414
namespace phpMussel\FrontEnd;
@@ -352,7 +352,7 @@ public function view(string $Page = '')
352352
/** Cleanup. */
353353
unset($Pips, $PipsData, $PipsPath);
354354

355-
/** Fire event: "frontend_before". */
355+
/** Fire event: "frontend_before_page". */
356356
$this->Loader->Events->fireEvent('frontend_before_page', '', $FE);
357357

358358
/** A simple passthru for non-private theme images and related data. */

0 commit comments

Comments
 (0)