PHPackages camelot/common - 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. camelot/common ActiveLibrary[Utility & Helpers](/categories/utility) camelot/common ============== Common utilities for all Camelot libraries v3.0.0(4y ago)0157↓100%MITPHPPHP ^8.1 Since Aug 31Pushed 4y ago1 watchersCompare [ Source](https://github.com/CamelotProject/common)[ Packagist](https://packagist.org/packages/camelot/common)[ RSS](/packages/camelot-common/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (8)Versions (7)Used By (0) Camelot Common ============== [](#camelot-common) This library provides utility functions to help simplify menial tasks. The Camelot team believes the PHP error reporting system is a mistake. Many built-in functions utilize it, leading to inconsistent results and head scratching. This library provides some wrappers around some of these functions. Our code should always throw exceptions instead of triggering errors/warnings/notices (excluding deprecation warnings). Table of Contents: - [Assert](#assert) - [Deprecated](#deprecated) - [Ini](#ini) - [Json](#json) - [Serialization](#serialization) - [Str](#str) --- `Assert` -------- [](#assert) Additional assertions built on `Webmozart\Assert` ### `isArrayAccessible` [](#isarrayaccessible) Throws `InvalidArgumentException` if `$value` is not an array or object implementing `ArrayAccess`. ``` isArrayAccessible($value, string $message = ''): void ``` ### `isInstanceOfAny` [](#isinstanceofany) Throws `InvalidArgumentException` if `$value` is not an instance of one of the given classes/interfaces. ``` isInstanceOfAny($value, string[] $classes, string $message = ''): void ``` ### `isIterable` [](#isiterable) Throws `InvalidArgumentException` if `$value` is not an *iterable*. Same as `isTraversable()`, just a better name. ``` isIterable($value, string $message = ''): void ``` `Deprecated` ------------ [](#deprecated) Helper methods for triggering deprecation warnings. ### `warn` [](#warn) Shortcut for triggering a deprecation warning for something. ``` warn(string $subject, string|float $since = null, string $suggest = ''): void ``` Examples: ``` // Triggers warning: "Doing foo is deprecated." Deprecated::warn('Doing foo'); // Triggers warning: "Doing foo is deprecated since 3.3 and will be removed in 4.0." Deprecated::warn('Doing foo', 3.3); // Triggers warning: "Doing foo is deprecated since 3.3 and will be removed in 4.0. Do bar instead." Deprecated::warn('Doing foo', 3.3, 'Do bar instead'); ``` ### `method` [](#method) Shortcut for triggering a deprecation warning for a method. ``` method(string|float $since = null, string $suggest = '', string $method = null): void ``` `$suggest` can be a sentence describing what to use instead. Or it can be a method name or `class::method` which will be converted to a sentence. `$method` defaults to the method/function it was called from. - If called from constructor, warning message says the class is deprecated. - If called from magic method, warning message says the method/property called with is deprecated. Example: ``` class Foo { public function world() { // Triggers warning: "Foo::world() is deprecated since 3.3 and will be removed in 4.0. Use hello() instead." Deprecated::method(3.3, 'hello'); } } ``` ### `cls` [](#cls) Shortcut for triggering a deprecation warning for a class. ``` cls(string $class, string|float $since = null, string $suggest = null): void ``` `$suggest` can be a sentence describing what to use instead. Or it can be a class name which will be converted to a sentence. Examples: ``` // Triggers warning: "Foo\Bar is deprecated." Deprecated::cls('Foo\Bar'); // Triggers warning: "Foo\Bar is deprecated. Use Bar\Baz instead." Deprecated::cls('Foo\Bar', null, 'Bar\Baz'); ``` `Ini` ----- [](#ini) Handles setting and retrieving values from PHP's configuration. ### `has` [](#has) Checks whether the key exists. ``` has(string $key): bool ``` ### `getStr` [](#getstr) Get a string value. The default is returned if the key does not exist or the value is empty. ``` getStr(string $key, string $default = null): ?string ``` ### `getBool` [](#getbool) Get a boolean value. False is returned if the key does not exist or the value is empty. ``` getBool(string $key): bool ``` ### `getNumeric` [](#getnumeric) Get a numeric value. The default is returned if the key does not exist or the value is empty. ``` getNumeric(string $key, int|float $default = null): int|float|null ``` ### `getBytes` [](#getbytes) Get a memory size value, such as `memory_limit`, and convert it to an integer. The default is returned if the key does not exist or the value is empty. ``` getBytes(string $key, int $default = null): ?int ``` ### `set` [](#set) Set a new value for the given key. Throws `RuntimeException` if the key does not exist, it is not editable, or something goes wrong. ``` set(string $key, ?scalar $value): void ``` `Json` ------ [](#json) Handles JSON parsing/dumping with error handling. ### `parse` [](#parse) Parses JSON *string* to *array* or *scalar*. Throws `ParseException` if anything goes wrong. ``` parse(string $json, int $options = 0, int $depth = 512): string ``` We use [`seld/jsonlint`](https://github.com/Seldaek/jsonlint) to determine why the parsing failed and include it in the exception message. ### `dump` [](#dump) Dumps *mixed* to JSON *string*. Throws `DumpException` if anything goes wrong. ``` dump(mixed $data, int $options = JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE, int $depth = 512): string ``` If input contains invalid UTF-8 characters we try to convert these for you before failing. ### `test` [](#test) Returns whether the string is valid JSON. ``` test(string $json): bool ``` `Serialization` --------------- [](#serialization) Handles PHP serialization parsing/dumping with error handling. ### `parse` [](#parse-1) Parses PHP serialized *string*. Throws `ParseException` if a serialized class cannot be found or anything else goes wrong. ``` parse(string $value, array $options = []): mixed ``` Note: `$options` parameter is ignored on PHP 5. See [`unserialize()`](http://php.net/manual/en/function.unserialize.php) for details. ### `dump` [](#dump-1) Dumps anything to a PHP serialized *string*. Throws `DumpException` if the input is not serializable or anything else goes wrong. ``` dump(mixed $value): string ``` `Str` ----- [](#str) Common string methods. ### `replaceFirst` [](#replacefirst) Replaces the first occurrence of the $search text on the $subject. ``` replaceFirst(string $subject, string $search, string $replace, bool $caseSensitive = true): string ``` ### `replaceLast` [](#replacelast) Replaces the last occurrence of the $search text on the $subject. ``` replaceLast(string $subject, string $search, string $replace, bool $caseSensitive = true): string ``` ### `removeFirst` [](#removefirst) Removes the first occurrence of the $search text on the $subject. ``` removeFirst(string $subject, string $search, bool $caseSensitive = true): string ``` ### `removeLast` [](#removelast) Removes the last occurrence of the $search text on the $subject. ``` removeLast(string $subject, string $search, bool $caseSensitive = true): string ``` ### `splitFirst` [](#splitfirst) Splits a $subject on the $delimiter and returns the first part. ``` splitFirst(string $subject, string $delimiter): string ``` ### `splitLast` [](#splitlast) Splits a $subject on the $delimiter and returns the last part. ``` splitLast(string $subject, string $delimiter): string ``` ### `endsWith` [](#endswith) Returns whether the subjects ends with the search string. ``` endsWith(string $subject, string $search, bool $caseSensitive = true): bool ``` ### `className` [](#classname) Returns the class name without the namespace, of a string FQCN, or object. ``` className(string|object $class): string ``` ### `humanize` [](#humanize) Converts a string from camel case and snake case to a human readable string. ``` humanize(string $text): string ``` ### `camelCase` [](#camelcase) Converts a string from snake case to camel case. ``` camelCase(string $text, bool $lowercaseFirstChar = false): string ``` ### `snakeCase` [](#snakecase) Converts a string from camel case to snake case. ``` snakeCase(string $text): string ``` ### Health Score 32 — LowBetter than 72% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity11 Limited adoption so far Community10 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 53.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~306 days Total 5 Last Release 1582d ago Major Versions v1.1.0 → v2.0.02021-11-08 v2.0.0 → v3.0.02022-01-09 PHP version history (3 changes)v1.0.0-beta1PHP ^7.1.3 v1.1.0PHP ^7.1.3 || ^8.0 v3.0.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/0c37c32df3696c9b0e3f97375ae3ce40576267523ff0ca1d42f638beb251e706?d=identicon)[gwendolen](/maintainers/gwendolen) --- Top Contributors [![CarsonF](https://avatars.githubusercontent.com/u/932566?v=4)](https://github.com/CarsonF "CarsonF (55 commits)")[![GwendolenLynch](https://avatars.githubusercontent.com/u/1427081?v=4)](https://github.com/GwendolenLynch "GwendolenLynch (46 commits)")[![bobdenotter](https://avatars.githubusercontent.com/u/1833361?v=4)](https://github.com/bobdenotter "bobdenotter (1 commits)") ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/camelot-common/health.svg) ``` [![Health](https://phpackages.com/badges/camelot-common/health.svg)](https://phpackages.com/packages/camelot-common) ``` ### Alternatives [phpdocumentor/reflection-docblock With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock. 9.4k722.2M1.2k](/packages/phpdocumentor-reflection-docblock)[symplify/monorepo-builder Not only Composer tools to build a Monorepo. 5205.3M82](/packages/symplify-monorepo-builder)[vaimo/composer-patches Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches. 2994.3M14](/packages/vaimo-composer-patches)[sylius/promotion Flexible promotion management for PHP applications. 28477.8k9](/packages/sylius-promotion)[bolt/common 🧰 Common utilities for all Bolt libraries 18340.8k8](/packages/bolt-common)[sylius/taxonomy Taxonomies - categorization of domain models in PHP projects. 14435.6k10](/packages/sylius-taxonomy) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)