PHPackages dynoser/base85 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. dynoser/base85 ActiveLibrary[Utility & Helpers](/categories/utility) dynoser/base85 ============== base85 encoder and decoder. ASCII85, vwx85, and vc85 (visually distinctive characters cyrillic) v1.0.2(2y ago)23Apache-2.0PHP Since Jan 9Pushed 2y ago1 watchersCompare [ Source](https://github.com/dynoser/base85)[ Packagist](https://packagist.org/packages/dynoser/base85)[ RSS](/packages/dynoser-base85/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (1)Versions (4)Used By (0) vc85 Encoding (base85vc) ======================== [](#vc85-encoding-base85vc) vc85 encoding is a variant of base85 (85-character chatset) and is compatible with ASCII85. - [There is a Wikipedia article on ASCII85](https://en.wikipedia.org/wiki/Ascii85) vc85: An Improved Version of ASCII85 Encoding --------------------------------------------- [](#vc85-an-improved-version-of-ascii85-encoding) The enhancement lies in the addition of alternative characters to the character set, which function identically to the "primary" ASCII85 characters. The vc85 decoder is backward-compatible with ASCII85 and can decode both ASCII85 and vc85 encodings. The vc85 character set is designed so that character codes in utf-8 and cp1251 do not overlap. Therefore, the decoder can handle all possible variants of base85, including ascii85, vwx85, and vc85. The differences between these encoding variants are as follows: - ascii85 consists of 85 consecutive ASCII characters from `!` to `u`, corresponding to the regular expression `[!-u]`. - vwx85 is similar to ascii85 but replaces three "awkward" characters: `v` instead of `"`, `w` instead of `'`, `x` instead of `\`. - vc85, in addition to the vwx85 replacements, substitutes all special characters with Cyrillic alphabet letters that visually differ from all other characters in the table. See the table: [![Charset](https://raw.githubusercontent.com/dynoser/base85/main/doc/vc85charset.png)](https://raw.githubusercontent.com/dynoser/base85/main/doc/vc85charset.png) Understanding Base-85 Encoding ------------------------------ [](#understanding-base-85-encoding) Base85 encoding encodes groups of 4 bytes into 5 characters, making it more compact than base64, which encodes groups of 3 bytes into 4 characters. Implementing base85 encoding is straightforward in most programming languages. It operates on 4-byte groups that fit into 32-bit numbers, making them easy to handle compared to higher-bit numbers. While base85 encoding could replace base64 in many scenarios, the presence of special characters complicates its use. It's not as simple as enclosing an ascii85-encoded string in quotes and inserting it into code because the string may contain quotes, backslashes, and other problematic characters. The vwx85 variant partly addresses this issue by removing quotes and backslashes from the character set since these characters often cause problems. This substitution makes it possible to include such data almost anywhere without issues. Since the characters `v`, `w`, and `x` are not used in the classic ascii85 variant, this substitution seems a logical solution to many problems. Characters `z` and `y` ---------------------- [](#characters-z-and-y) As historically, the characters `z` and `y` were used to encode 5 null bytes and 5 spaces, respectively, the vc85 decoder also supports these rules. Prefixes and Suffixes --------------------- [](#prefixes-and-suffixes) Since the base85 character set does not include the tilde `~`, it can be used as a marker to indicate the end of encoded data. In the complete format, data in base85 encoding is enclosed between `` at the end of the encoded data block. The current vc85 decoder implementation trims decoded data based on these prefixes and suffixes. If `` is encountered, all subsequent data will be discarded. Whitespace Characters --------------------- [](#whitespace-characters) Spaces and line breaks are ignored and can appear anywhere. Representations in utf-8 and cp1251 ----------------------------------- [](#representations-in-utf-8-and-cp1251) The Cyrillic characters added to the vc85 charset can be represented in utf-8 or cp1251 encodings. The decoder understands both variants. It's worth noting that in cp1251, all characters are represented by 1-byte codes, while in utf-8, Cyrillic characters are represented by two-byte codes (starting either with 208 or 209). In this implementation, when decoding utf-8, codes 208 and 209 are removed, resulting in one-byte encoding. Therefore, no conversions between utf-8 and cp1251 are required. Usage (for PHP) =============== [](#usage-for-php) To use vc85, simply include the file vc85.php. For encoding data, use the static function `encode`, and for decoding, use the static function `decode`. Example code: ```