mirror of
https://github.com/itflow-org/itflow
synced 2026-09-22 06:31:15 +00:00
Update imapengine dependancies too
This commit is contained in:
40
libs/vendor/zbateson/mb-wrapper/README.md
vendored
40
libs/vendor/zbateson/mb-wrapper/README.md
vendored
@@ -2,51 +2,41 @@
|
||||
|
||||
Charset conversion and string manipulation wrapper with a large defined set of aliases.
|
||||
|
||||
[](https://github.com/zbateson/mb-wrapper.svg/actions/workflows/tests.yml)
|
||||
[](https://scrutinizer-ci.com/g/zbateson/mb-wrapper/?branch=master)
|
||||
[](https://scrutinizer-ci.com/g/zbateson/mb-wrapper/?branch=master)
|
||||
[](https://github.com/zbateson/mb-wrapper/actions/workflows/tests.yml)
|
||||
[](https://packagist.org/packages/zbateson/mb-wrapper)
|
||||
[](https://packagist.org/packages/zbateson/mb-wrapper)
|
||||
|
||||
The goals of this project are to be:
|
||||
|
||||
* Well written
|
||||
* Tested where possible
|
||||
* Support as wide a range of charset aliases as possible
|
||||
|
||||
To include it for use in your project, please install via composer:
|
||||
|
||||
```
|
||||
composer require zbateson/mb-wrapper
|
||||
```
|
||||
|
||||
## Php 7 Support Dropped
|
||||
## Sponsors
|
||||
|
||||
As of mb-wrapper 2.0, support for php 7 has been dropped.
|
||||
[](https://secumailer.com)
|
||||
|
||||
A huge thank you to [all my sponsors](https://github.com/sponsors/zbateson). <3
|
||||
|
||||
If this project's helped you, please consider [sponsoring me](https://github.com/sponsors/zbateson).
|
||||
|
||||
## Requirements
|
||||
|
||||
mb-wrapper requires PHP 8.0 or newer. Tested on PHP 8.0, 8.1, 8.2, and 8.3 on GitHub Actions.
|
||||
|
||||
## New in 2.0
|
||||
|
||||
If converting or performing an operation on a string fails in iconv, an UnsupportedCharsetException is now thrown.
|
||||
PHP 8.1 or newer. Tested on PHP 8.1, 8.2, 8.3, 8.4, and 8.5.
|
||||
|
||||
## Description
|
||||
|
||||
MbWrapper is intended for use wherever mb_* or iconv_* is used. It scans supported charsets returned by mb_list_encodings(), and prefers mb_* functions, but will fallback to iconv if a charset isn't supported by the mb_ functions.
|
||||
MbWrapper is intended for use wherever `mb_*` or `iconv_*` is used. It scans supported charsets returned by `mb_list_encodings()`, and prefers `mb_*` functions, but will fallback to `iconv` if a charset isn't supported by the `mb_*` functions.
|
||||
|
||||
A list of aliased charsets is maintained for both mb_* and iconv, where a supported charset exists for an alias. This is useful for mail and http parsing as other systems may report encodings not recognized by mb_* or iconv.
|
||||
A list of aliased charsets is maintained for both `mb_*` and `iconv`, where a supported charset exists for an alias. This is useful for mail and http parsing as other systems may report encodings not recognized by `mb_*` or `iconv`.
|
||||
|
||||
Charset lookup is done by removing non-alphanumeric characters as well, so UTF8 will always be matched to UTF-8, etc...
|
||||
Charset lookup is done by removing non-alphanumeric characters as well, so `UTF8` will always be matched to `UTF-8`, etc.
|
||||
|
||||
## Usage
|
||||
|
||||
The following wrapper methods are exposed:
|
||||
* mb_convert_encoding, iconv with MbWrapper::convert
|
||||
* mb_substr, iconv_substr with MbWrapper::getSubstr
|
||||
* mb_strlen, iconv_strlen with MbWrapper::getLength
|
||||
* mb_check_encoding, iconv (for verification) with MbWrapper::checkEncoding
|
||||
* `mb_convert_encoding`, `iconv` with `MbWrapper::convert`
|
||||
* `mb_substr`, `iconv_substr` with `MbWrapper::getSubstr`
|
||||
* `mb_strlen`, `iconv_strlen` with `MbWrapper::getLength`
|
||||
* `mb_check_encoding`, `iconv` (for verification) with `MbWrapper::checkEncoding`
|
||||
|
||||
```php
|
||||
$mbWrapper = new \ZBateson\MbWrapper\MbWrapper();
|
||||
|
||||
Reference in New Issue
Block a user