Skip to content

Commit af83bea

Browse files
committed
v2.1.4
1 parent 240ca5b commit af83bea

16 files changed

+90
-112
lines changed

readme.ar.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -233,17 +233,11 @@ https://github.com/phpMussel/phpMussel>v2
233233
│ Changelog-v2.txt
234234
│ codeception.yml
235235
│ composer.json
236-
│ CONTRIBUTING.md
237236
│ LICENSE.txt
238237
│ loader.php
239-
│ PEOPLE.md
240238
│ README.md
241-
│ SECURITY.md
242239
│ web.config
243240
244-
├───.github
245-
│ ISSUE_TEMPLATE.md
246-
247241
├───tests
248242
│ │ .gitignore
249243
│ │ acceptance.suite.yml
@@ -317,6 +311,7 @@ https://github.com/phpMussel/phpMussel>v2
317311
│ │ Demojibakefier.php
318312
│ │ Events.php
319313
│ │ L10N.php
314+
│ │ Matrix.php
320315
│ │ NumberFormatter.php
321316
│ │ YAML.php
322317
│ │
@@ -1009,7 +1004,7 @@ Phar | ❌ | ❌ | ❌ | &nbsp; <div dir="rtl" style="display:inline">تمت إ
10091004

10101005
##### <div dir="rtl">"only_allow_images"<br /></div>
10111006
<div dir="rtl"><ul>
1012-
<li>إذا كنت تتوقع فقط أو تنوي فقط للسماح الصور المراد تحميلها على النظام الخاص بك أو CMS، وإذا كنت على الاطلاق لا تتطلب أية ملفات أخرى من الصور ليتم تحميلها على النظام الخاص بك أو CMS، ينبغي تمكين هذا التوجيه، ولكن ينبغي خلاف ذلك يتم تعطيل. إذا تم تمكين هذا التوجيه، أنه سوف يكلف phpMussel لمنع عشوائيا أي الإضافات التي تم تحديدها كملفات صورة غير، دون مسحها. هذا قد يقلل من الوقت اللازم لتجهيز واستخدام الذاكرة لمحاولة تحميل الملفات غير الصورة. زائفة/False = OFF؛ صحيح/True = ON.</li>
1007+
<li>عند التعيين على true، أي ملفات ليست صورًا واجهها الماسح الضوئي سيتم وضع علامة على الفور، دون أن يتم فحصها. قد يساعد هذا في تقليل الوقت اللازم لإكمال الفحص في بعض الحالات. تعيين على false بشكل افتراضي.</li>
10131008
</ul></div>
10141009

10151010
#### <div dir="rtl">"heuristic" (التصنيف)<br /></div>

readme.de.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -239,17 +239,11 @@ https://github.com/phpMussel/phpMussel>v2
239239
│ Changelog-v2.txt
240240
│ codeception.yml
241241
│ composer.json
242-
│ CONTRIBUTING.md
243242
│ LICENSE.txt
244243
│ loader.php
245-
│ PEOPLE.md
246244
│ README.md
247-
│ SECURITY.md
248245
│ web.config
249246
250-
├───.github
251-
│ ISSUE_TEMPLATE.md
252-
253247
├───tests
254248
│ │ .gitignore
255249
│ │ acceptance.suite.yml
@@ -323,6 +317,7 @@ https://github.com/phpMussel/phpMussel>v2
323317
│ │ Demojibakefier.php
324318
│ │ Events.php
325319
│ │ L10N.php
320+
│ │ Matrix.php
326321
│ │ NumberFormatter.php
327322
│ │ YAML.php
328323
│ │
@@ -870,7 +865,7 @@ Kompatibilitätsdirektiven für phpMussel.
870865
- Diese Direktive sollte generell AUS geschaltet bleiben sofern es nicht für die korrekte Funktion von phpMussel auf Ihrem System benötigt wird. Normalerweise, sobald phpMussel bei AUS geschalteter Direktive ein Element in `$_FILES` array() erkennt, wird es beginnen, die Dateien, die diese Elemente repräsentieren, zu überprüfen, sollten diese Elemente leer sein, gibt phpMussel eine Fehlermeldung zurück. Dies ist das normale Verhalten von phpMussel. Bei einigen CMS werden allerdings als normales Verhalten leere Elemente in `$_FILES` zurückgegeben oder Fehlermeldungen ausgelöst, sobald sich dort keine leeren Elemente befinden, in diesem Fall tritt ein Konflikt zwischen dem normalen Verhalten von phpMussel und dem CMS auf. Sollte eine solche Konstellation bei Ihrem CMS zutreffen, so stellen Sie diese Option AN, phpMussel wird somit nicht nach leeren Elementen suchen, Sie bei einem Fund ignorieren und keine zugehörigen Fehlermeldungen ausgeben, der Request zum Seitenaufruf kann somit fortgesetzt werden. False = AUS/OFF; True = AN/ON.
871866

872867
##### "only_allow_images"
873-
- Wenn Sie nur Bilder erwarten, die auf Ihr System oder CMS hochgeladen werden oder nur Bilder und keine anderen Dateien als Upload erlauben oder benötigen, so sollte diese Direktive aktiviert werden (ON), ansonsten deaktiviert bleiben (OFF). Ist diese Direktive aktiviert, wird phpMussel alle Uploads, die keine Bilddateien sind, blockieren, ohne sie zu scannen. Dies kann die Verarbeitungszeit und Speichernutzung reduzieren, sobald andere Nicht-Bilddateien hochgeladen werden. False = AUS/OFF; True = AN/ON.
868+
- Wenn auf true gesetzt, alle vom Scanner gefundenen Dateien die keine Bilder sind, werden sofort markiert, ohne gescannt zu werden. Dies kann in einigen Fällen hilfreich sein für die Durchführung eines Scans erforderliche Zeit zu verkürzen. Standardmäßig auf false gesetzt.
874869

875870
#### "heuristic" (Kategorie)
876871
Heuristic-Direktive für phpMussel.

readme.en.md

Lines changed: 60 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@
1212
- 9. [KNOWN COMPATIBILITY PROBLEMS](#SECTION9)
1313
- 10. [FREQUENTLY ASKED QUESTIONS (FAQ)](#SECTION10)
1414
- 11. [LEGAL INFORMATION](#SECTION11)
15+
- 12. [MIGRATION GUIDE](#SECTION12)
1516

1617
*Note regarding translations: In the event of errors (e.g., discrepancies between translations, typos, etc), the English version of the README is considered the original and authoritative version. If you find any errors, your assistance in correcting them would be welcomed.*
1718

@@ -238,17 +239,11 @@ https://github.com/phpMussel/phpMussel>v2
238239
│ Changelog-v2.txt
239240
│ codeception.yml
240241
│ composer.json
241-
│ CONTRIBUTING.md
242242
│ LICENSE.txt
243243
│ loader.php
244-
│ PEOPLE.md
245244
│ README.md
246-
│ SECURITY.md
247245
│ web.config
248246
249-
├───.github
250-
│ ISSUE_TEMPLATE.md
251-
252247
├───tests
253248
│ │ .gitignore
254249
│ │ acceptance.suite.yml
@@ -322,6 +317,7 @@ https://github.com/phpMussel/phpMussel>v2
322317
│ │ Demojibakefier.php
323318
│ │ Events.php
324319
│ │ L10N.php
320+
│ │ Matrix.php
325321
│ │ NumberFormatter.php
326322
│ │ YAML.php
327323
│ │
@@ -869,7 +865,7 @@ Compatibility directives for phpMussel.
869865
- This directive should generally be disabled unless it's required for correct functionality of phpMussel on your specific system. Normally, when disabled, when phpMussel detects the presence of elements in the `$_FILES` array(), it'll attempt to initiate a scan of the files that those elements represent, and, if those elements are blank or empty, phpMussel will return an error message. This is proper behaviour for phpMussel. However, for some CMS, empty elements in `$_FILES` can occur as a result of the natural behaviour of those CMS, or errors may be reported when there aren't any, in which case, the normal behaviour for phpMussel will be interfering with the normal behaviour of those CMS. If such a situation occurs for you, enabling this option will instruct phpMussel to not attempt to initiate scans for such empty elements, ignore them when found and to not return any related error messages, thus allowing continuation of the page request. False = OFF; True = ON.
870866

871867
##### "only_allow_images"
872-
- If you only expect or only intend to allow images to be uploaded to your system or CMS, and if you absolutely don't require any files other than images to be uploaded to your system or CMS, this directive should be enabled, but should otherwise be disabled. If this directive is enabled, it'll instruct phpMussel to indiscriminately block any uploads identified as non-image files, without scanning them. This may reduce processing time and memory usage for attempted uploads of non-image files. False = OFF; True = ON.
868+
- When set to true, any files encountered by the scanner which aren't images will be flagged immediately, without being scanned. This may help reduce the time needed to complete a scan in some cases. Set to false by default.
873869

874870
#### "heuristic" (Category)
875871
Heuristic directives.
@@ -1759,4 +1755,61 @@ Alternatively, there's a brief (non-authoritative) overview of GDPR/DSGVO availa
17591755
---
17601756

17611757

1758+
### 12. <a name="SECTION12"></a>MIGRATION GUIDE
1759+
1760+
#### 12.0 MIGRATING FROM v0 TO v1
1761+
1762+
##### 12.0.0 SUMMARY
1763+
1764+
There are significant backwards-incompatible changes between v0 and v1, to the extent they could almost be regarded as entirely different packages. Also, at the time of writing this migrating guide, v0 has already reached EoL since a long time ago, so starting again afresh with a completely new installation is the most recommended way forward (preferably just skipping ahead directly to v2 or newer, if possible).
1765+
1766+
##### 12.0.1 REQUIREMENTS
1767+
1768+
phpMussel v1 requires at least PHP 5.4 or newer with PCRE support. Ensure you meet the requirements before attempting to install, update, or migrate. BZ2 support, cURL support, LZF support, RAR support, and ZIP support is also strongly recommended (though the package should still mostly function without it).
1769+
1770+
##### 12.0.2 BACKWARDS-INCOMPATIBLE CHANGES, DEPRECATIONS, ETC
1771+
1772+
Too many to list.
1773+
1774+
##### 12.0.3 NEW FEATURES, BENEFITS, OTHER CHANGES, ETC
1775+
1776+
Too many to list.
1777+
1778+
#### 12.1 MIGRATING FROM v1 TO v2
1779+
1780+
##### 12.1.0 SUMMARY
1781+
1782+
Some backwards-incompatible changes exist between v1 and v2, and migrating directly from the front-end isn't possible. If you haven't changed anything at your existing installation at all (e.g., configuration hasn't changed from any of the default values, no new plugins or signature files have been installed, no custom signatures, etc), or if you don't care about retaining your existing configuration, customistaions, any old logs or other old data, just starting again afresh with a completely new installation would be the easiest, simplest, and most recommended way forward. Otherwise, if you want to preserve anything from your existing installation, follow the steps below to migrate manually from v1 to v2.
1783+
1784+
##### 12.1.1 REQUIREMENTS
1785+
1786+
phpMussel v2 requires at least PHP 7.2 or newer with PCRE support. Ensure you meet the requirements before attempting to install, update, or migrate. BZ2 support, cURL support, LZF support, RAR support, and ZIP support is also strongly recommended (though the package should still mostly function without it).
1787+
1788+
##### 12.1.2 BACKWARDS-INCOMPATIBLE CHANGES, DEPRECATIONS, ETC
1789+
1790+
- Minimum requirements raised.
1791+
- Some small changes to the loader.
1792+
- The code for processing plugins shifted from the loader to the functions file and reworked.
1793+
- Numerous configuration directives renamed in order to implement snake_case.
1794+
1795+
##### 12.1.3 NEW FEATURES, BENEFITS, OTHER CHANGES, ETC
1796+
1797+
- Support for 4 additional languages added (20 total supported by v1; 24 total supported by v2).
1798+
- Very slight overall performance improvements may be noticeable in some circumstances.
1799+
- Slightly stronger typecasting and future-proofing.
1800+
- Codebase refactored to take advantage of syntax and features available to PHP since the raised minimum requirements (e.g., scalar parameter type hints, return type declarations, generators, etc).
1801+
1802+
##### 12.1.4 STEPS TO MIGRATE
1803+
1804+
*To-do.*
1805+
1806+
#### 12.2 MIGRATING FROM v2 TO v3
1807+
1808+
##### 12.2.0 SUMMARY
1809+
1810+
v3 doesn't exist yet. More information will be provided at a later time, when it becomes relevant.
1811+
1812+
---
1813+
1814+
17621815
Last Updated: 1 March 2020 (2020.03.01).

readme.es.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -238,17 +238,11 @@ https://github.com/phpMussel/phpMussel>v2
238238
│ Changelog-v2.txt
239239
│ codeception.yml
240240
│ composer.json
241-
│ CONTRIBUTING.md
242241
│ LICENSE.txt
243242
│ loader.php
244-
│ PEOPLE.md
245243
│ README.md
246-
│ SECURITY.md
247244
│ web.config
248245
249-
├───.github
250-
│ ISSUE_TEMPLATE.md
251-
252246
├───tests
253247
│ │ .gitignore
254248
│ │ acceptance.suite.yml
@@ -322,6 +316,7 @@ https://github.com/phpMussel/phpMussel>v2
322316
│ │ Demojibakefier.php
323317
│ │ Events.php
324318
│ │ L10N.php
319+
│ │ Matrix.php
325320
│ │ NumberFormatter.php
326321
│ │ YAML.php
327322
│ │
@@ -869,7 +864,7 @@ Compatibilidad directivas para phpMussel.
869864
- Esta directiva, en general, debe ser desactivado, a menos que se requiere para la correcta funcionalidad de phpMussel en su específico sistema. Normalmente, cuando está desactivado, cuando phpMussel detecta la presencia de elementos en la `$_FILES` array(), intentará iniciar un escaneo de los archivos que esos elementos representan, y, si esos elementos están blanco o vacío, phpMussel devolverá un mensaje de error. Este es el comportamiento natural para phpMussel. Pero, para algunos CMS, vacíos elementos en `$_FILES` puede ocurrir como resultado del comportamiento natural de los CMS, o errores pueden ser reportados cuando no existe ninguna, en cuyo caso, el comportamiento natural para phpMussel será interfiriendo con el comportamiento natural de los CMS. Si tal situación ocurre para usted, activando esta opción instruirá phpMussel no intentar iniciar un escaneo para tales vacíos elementos, ignorarlos cuando encontrado y no devuelva cualquier relacionado mensaje de error, así permitiendo la continuación de la página cargando. False = DESACTIVADO; True = ACTIVADO.
870865

871866
##### "only_allow_images"
872-
- Si usted sólo esperas o sólo quieren permitir imágenes para ser subido a su sistema o CMS, y si usted absolutamente no requiere cualquieres archivos otro que imágenes para subir a su sistema o CMS, esta directiva debe ser activado, pero por lo demás debe ser desactivado. Si esta directiva está activada, se instruirá phpMussel para indiscriminadamente bloquear cualquieres subidos identificado como archivos que no son imagen, sin escaneandolos. Esto puede reducir el tiempo de procesamiento y el uso de memoria para intentados subidos de archivos que no son imagen. False = DESACTIVADO; True = ACTIVADO.
867+
- Cuando es true, cualquier archivo encontrado por el escáner que no sean imágenes se marcará de inmediato, sin ser escaneado. Esto puede ayudar a reducir el tiempo necesario para completar una escaneo en algunos casos. Establecido en falso por predeterminado.
873868

874869
#### "heuristic" (Categoría)
875870
Heurísticas directivas para phpMussel.

readme.fr.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -238,17 +238,11 @@ https://github.com/phpMussel/phpMussel>v2
238238
│ Changelog-v2.txt
239239
│ codeception.yml
240240
│ composer.json
241-
│ CONTRIBUTING.md
242241
│ LICENSE.txt
243242
│ loader.php
244-
│ PEOPLE.md
245243
│ README.md
246-
│ SECURITY.md
247244
│ web.config
248245
249-
├───.github
250-
│ ISSUE_TEMPLATE.md
251-
252246
├───tests
253247
│ │ .gitignore
254248
│ │ acceptance.suite.yml
@@ -322,6 +316,7 @@ https://github.com/phpMussel/phpMussel>v2
322316
│ │ Demojibakefier.php
323317
│ │ Events.php
324318
│ │ L10N.php
319+
│ │ Matrix.php
325320
│ │ NumberFormatter.php
326321
│ │ YAML.php
327322
│ │
@@ -869,7 +864,7 @@ Directives de compatibilité pour phpMussel.
869864
- Cette directive doit généralement être DÉSACTIVÉ sauf si cela est nécessaire pour la correcte fonctionnalité de phpMussel sur votre spécifique système. Normalement, lorsque DÉSACTIVÉ, lorsque phpMussel détecte la présence d'éléments dans le `$_FILES`() tableau, il va tenter de lancer une analyse du fichiers que ces éléments représentent, et, si ces éléments sont vide, phpMussel retourne un message d'erreur. Ce comportement est normal pour phpMussel. Mais, pour certains CMS, vides éléments dans `$_FILES` peuvent survenir à la suite du naturel comportement de ces CMS, ou erreurs peuvent être signalés quand il ne sont pas tout, dans ce cas, le normal comportement pour phpMussel seront interférer avec le normal comportement de ces CMS. Si telle une situation se produit pour vous, ACTIVATION de cette option sera instruire phpMussel ne pas à tenter de lancer d'analyses pour ces vides éléments, ignorer quand il est reconnu et ne pas à retourner tout de connexes messages d'erreur, permettant ainsi la continuation de la requête de page. False = DÉSACTIVÉ ; True = ACTIVÉ.
870865

871866
##### « only_allow_images »
872-
- Si vous seulement attendre ou vouloir d'autoriser images à être téléchargé sur votre système ou CMS, et si vous absolument n'avez pas besoin tous les fichiers autres que les images à être téléchargé sur votre système ou CMS, cette directive devrait être ACTIVÉ, mais devrait autrement être DÉSACTIVÉ. Si cette directive est ACTIVÉ, il va instruire phpMussel à bloquer indistinctement tous téléchargements identifié comme non image fichiers, sans analyser. Cela peut réduire le temps de travail et l'utilisation de la mémoire pour les tentativé téléchargements de non image fichiers. False = DÉSACTIVÉ ; True = ACTIVÉ.
867+
- Lorsqu'il est défini sur true, tous les fichiers rencontrés par le scanner qui ne sont pas des images seront immédiatement marqués, sans être analysés. Cela peut aider à réduire le temps nécessaire pour terminer une analyse dans certains cas. Défini sur false par défaut.
873868

874869
#### « heuristic » (Catégorie)
875870
Directives heuristiques pour phpMussel.

readme.id.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -238,17 +238,11 @@ https://github.com/phpMussel/phpMussel>v2
238238
│ Changelog-v2.txt
239239
│ codeception.yml
240240
│ composer.json
241-
│ CONTRIBUTING.md
242241
│ LICENSE.txt
243242
│ loader.php
244-
│ PEOPLE.md
245243
│ README.md
246-
│ SECURITY.md
247244
│ web.config
248245
249-
├───.github
250-
│ ISSUE_TEMPLATE.md
251-
252246
├───tests
253247
│ │ .gitignore
254248
│ │ acceptance.suite.yml
@@ -322,6 +316,7 @@ https://github.com/phpMussel/phpMussel>v2
322316
│ │ Demojibakefier.php
323317
│ │ Events.php
324318
│ │ L10N.php
319+
│ │ Matrix.php
325320
│ │ NumberFormatter.php
326321
│ │ YAML.php
327322
│ │
@@ -869,7 +864,7 @@ Direktif-direktif kompatibilitas pada phpMussel.
869864
- Direktif ini umumnya harus DINONAKTIFKAN kecuali diharuskan untuk fungsi yang benar dari phpMussel pada sistem tertentu. Biasanya, ketika DINONAKTIFKAN, ketika phpMussel mendeteksi adanya elemen dalam `$_FILES` array(), itu akan mencoba untuk memulai scan file yang mewakili elemen, dan, jika elemen yang kosong, phpMussel akan mengembalikan pesan kesalahan. Ini adalah perilaku yang tepat untuk phpMussel. Namun, untuk beberapa CMS, elemen kosong di `$_FILES` dapat terjadi sebagai akibat dari perilaku alami itu CMS, atau kesalahan dapat dilaporkan bila tidak ada, dalam kasus seperti itu, perilaku normal untuk phpMussel akan mengganggu untuk perilaku normal itu CMS. Jika situasi seperti itu terjadi untuk Anda, MENGAKTIFKAN direktif ini akan menginstruksikan phpMussel untuk tidak mencoba untuk memulai scan untuk elemen kosong, mengabaikan saat ditemui dan untuk tidak kembali terkait pesan kesalahan, sehingga memungkinkan kelanjutan dari halaman permintaan. False = DINONAKTIFKAN; True = DIAKTIFKAN.
870865

871866
##### "only_allow_images"
872-
- Jika Anda hanya mengharapkan atau hanya berniat untuk memungkinkan mengupload gambar ke sistem atau CMS, dan jika Anda benar-benar tidak memerlukan mengupload file selain gambar ke sistem atau CMS, direktif ini harus DIAKTIFKAN, tapi sebaliknya harus DINONAKTIFKAN. Jika direktif ini DIAKTIFKAN, ini akan menginstruksikan phpMussel untuk memblokir tanpa pandang bulu setiap upload diidentifikasi sebagai file tidak gambar, tanpa pemindaian mereka. Ini mungkin mengurangi waktu memproses dan penggunaan memori untuk mencoba upload file tidak gambar. False = DINONAKTIFKAN; True = DIAKTIFKAN.
867+
- Bila diset ke true, file apapun ditemukan oleh pemindai yang bukan gambar akan segera ditandai, tanpa dipindai. Ini dapat membantu mengurangi waktu yang dibutuhkan untuk menyelesaikan pemindaian dalam beberapa kasus. Diset ke false secara default.
873868

874869
#### "heuristic" (Kategori)
875870
Direktif-direktif heuristik pada phpMussel.

0 commit comments

Comments
 (0)