PHPackages                             headzoo/utilities - 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. headzoo/utilities

AbandonedLibrary[Utility & Helpers](/categories/utility)

headzoo/utilities
=================

A collection of use PHP utility classes and functions.

0.6.3.2(11y ago)015712MITPHPPHP >=5.5.0

Since Mar 23Pushed 11y ago1 watchersCompare

[ Source](https://github.com/headzoo/utilities)[ Packagist](https://packagist.org/packages/headzoo/utilities)[ RSS](/packages/headzoo-utilities/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (2)Dependencies (1)Versions (17)Used By (2)

Headzoo Core v0.6.3.2
=====================

[](#headzoo-core-v0632)

A collection of use PHP utility classes and functions.

- [Overview](#overview)
- [Requirements](#requirements)
- [Installing](#installing)
- [Class Overview](#class-overview)
- [Quick Start](#quick-start)
- [Change Log](#change-log)
- [License](#license)

Overview
--------

[](#overview)

This project is a collection of classes, methods, and functions which I've created over the years, and I use them in most of my other projects. The purpose of this project is putting all my useful code in one place. I'll be adding to this framework as I find useful classes from my other projects that I think should go into the core.

Requirements
------------

[](#requirements)

- [PHP 5.5 or greater](https://php.net/downloads.php).
- [psr/Log](https://github.com/php-fig/log).

Installing
----------

[](#installing)

The library may be installed using either git or composer.

##### Git

[](#git)

Simply clone the project with the following command.

```
git clone git@github.com:headzoo/core.git

```

##### Composer

[](#composer)

Add the project to your composer.json as a dependency.

```
"require": {
    "headzoo/core" : "dev-master"
}

```

Class Overview
--------------

[](#class-overview)

The full class API documentation is available in the [/docs](docs/README.md) directory and the [wiki](https://github.com/headzoo/core/wiki).

##### [Core\\Arrays](https://github.com/headzoo/core/wiki/Arrays)

[](#corearrays)

Contains static methods for working with arrays.

##### [Core\\Strings](https://github.com/headzoo/core/wiki/Strings)

[](#corestrings)

Contains static methods for working with strings.

##### [Core\\Objects](https://github.com/headzoo/core/wiki/Objects)

[](#coreobjects)

Contains static methods for working with objects and classes.

##### [Core\\ErrorHandler](https://github.com/headzoo/core/wiki/ErrorHandler)

[](#coreerrorhandler)

Used to capture and gracefully handle core errors and exceptions.

##### [Core\\Errors](https://github.com/headzoo/core/wiki/Errors)

[](#coreerrors)

Utility class used to work with E\_ERROR constants.

##### [Core\\Profiler](https://github.com/headzoo/core/wiki/Profiler)

[](#coreprofiler)

Used to profile code.

##### [Core\\Conversions](https://github.com/headzoo/core/wiki/Conversions)

[](#coreconversions)

Utility class for converting from one value to another.

##### [Core\\ConstantsTrait](https://github.com/headzoo/core/wiki/ConstantsTrait)

[](#coreconstantstrait)

Trait for reflecting on class constants.

##### [Core\\AbstractEnum](https://github.com/headzoo/core/wiki/AbstractEnum)

[](#coreabstractenum)

Abstract class for creating enumerator classes.

##### [Core\\SmartCallable](https://github.com/headzoo/core/wiki/SmartCallable)

[](#coresmartcallable)

Used to call a function when a resource is no longer needed.

##### [Core\\ConfigurableCallable](https://github.com/headzoo/core/wiki/ConfigurableCallable)

[](#coreconfigurablecallable)

Creates a callable instance with configurable behavior.

##### [Core\\FunctionsTrait](https://github.com/headzoo/core/wiki/FunctionsTrait)

[](#corefunctionstrait)

Contains methods for working with functions and methods.

##### [Core\\Comparator](https://github.com/headzoo/core/wiki/Comparator)

[](#corecomparator)

Contains static methods for making comparisons between values.

Quick Start
-----------

[](#quick-start)

This quick start guide *briefly* goes over a few of the classes. The full class API documentation is available in the [/docs](docs/README.md) directory.

#### Core\\Strings

[](#corestrings-1)

```
echo Strings::camelCaseToUnderscore("CamelCaseString");
// Outputs: "camel_case_string"

echo Strings::camelCaseToUnderscore("MaryHadALittleLamb");
// Outputs: "mary_had_a_little_lamb"

$is = Strings::startsUpper("Welcome my son, welcome to the machine.");
var_dump($is);

// Output: bool(true);

$is = Strings::startsUpper("you've been in the pipeline, filling in time");
var_dump($is);

// Output: bool(false)

// Truncating a string at the end.
echo Strings::truncate("Mary had a little lamb, whose fleece was white as snow.", 20, Strings::TRUNC_END);

// Outputs: "Mary had a little..."

// Truncating a string at the start.
echo Strings::truncate("Mary had a little lamb, whose fleece was white as snow.", 20, Strings::TRUNC_START);

// Outputs: "...as white as snow."

// Truncating a string in the middle.
echo Strings::truncate("Mary had a little lamb, whose fleece was white as snow.", 20, Strings::TRUNC_MIDDLE);

// Outputs: "Mary ha...e as snow."
```

#### Core\\Arrays

[](#corearrays-1)

```
$array = [
   "headzoo",
   "joe",
   "sam"
];

echo Arrays::conjunct($array);
// Outputs: headzoo, joe, and sam

// Using a callback to quote the array values.
echo Arrays::conjunct($array, "and", 'Headzoo\Core\Strings::quote');
// Outputs: 'headzoo', 'joe', and 'sam'

$arr = [
 0 => [
     "username" => "headzoo",
     "email" => "sean@headzoo.io"
 ],
 1 => [
     "username" => "joe",
     "email" => "joe@headzoo.io"
 ]
]

$ret = Arrays::column($arr, "username");

// Outputs: ["headzoo", "joe"]
```

#### Core\\Objects

[](#coreobjects-1)

```
// Testing whether an object is an instance of another.
$is = Objects::isInstance(new stdClass(), stdClass);
var_dump($is);
// Outputs: bool(true)

// Unlike the instanceof operator, the second argument can be a string.
$is = Objects::isInstance(new stdClass(), 'stdClass');
var_dump($is);
// Outputs: bool(true);

// You can even test an array of objects.
$objects = [
    new stdClass(),
    new stdClass()
];
$is = Objects::isInstance($objects, stdClass);
var_dump($is);
// Outputs: bool(true)
```

#### Core\\ErrorHandler

[](#coreerrorhandler-1)

```
// Capture all errors, and display an error page instead of the usual php
// error message.
$handler = new ErrorHandler();
$handler->handle();

// Setup your own way of handing errors.
$handler = new ErrorHandler();
$handler->setCallback(function($handler) {
	include("template/error.php");
});
$handler->handle()

// Even handle errors different in different environments.
$handler = new ErrorHandler();
$handler->setCallback("dev", function($handler) {
	include("template/error_dev.php");
});
$handler->setCallback("live", function($handler) {
	include("template/error_live.php");
});
$handler->handle("live");
```

#### Core\\Profiler

[](#coreprofiler-1)

```
// The most basic profiling.
$profiler = new Profiler();
$profiler->start();
... do something here ...
$micro = $profiler->stop();
var_dump($micro);

// Outputs:
// "Profile time for 'default': 0.00030207633972168"
// double(0.00030207633972168)

// This example runs the closure 100 times, and displays the profile results.
Profiler::run(100, true, function() {
  ... do something here ...
});

// Output:
//
// Total Runs:                 100
// Total Time:      0.099596977234
// Average Time:    0.000981624126
// -------------------------------
// Run #1           0.000479936599
// Run #2           0.000968933105
// Run #3           0.000982999801
// Run #4           0.000988006591
// ......
// Run #97          0.000985145568
// Run #98          0.000983953476
// Run #99          0.000997066497
// Run #100         0.000993013382
```

#### Core\\AbstractEnum

[](#coreabstractenum-1)

```
class DaysEnum
   extends AbstractEnum
{
   const SUNDAY    = "SUNDAY";
   const MONDAY    = "MONDAY";
   const TUESDAY   = "TUESDAY";
   const WEDNESDAY = "WEDNESDAY";
   const THURSDAY  = "THURSDAY";
   const FRIDAY    = "FRIDAY";
   const SATURDAY  = "SATURDAY";
   const __DEFAULT = self::SUNDAY;
}

$day = new DaysEnum("SUNDAY");
echo $day;
echo $day->value();

// Outputs:
// "SUNDAY"
// "SUNDAY"

// The default value is used when not specified.
$day = new DaysEnum();
echo $day;

// Outputs: "SUNDAY"

// The constructor value is not case-sensitive.
$day = new DaysEnum("sUndAy");
echo $day;

// Outputs: "SUNDAY"

// Enum values are easy to compare.
$day_tue1 = new DaysEnum(DaysEnum::TUESDAY);
$day_fri1 = new DaysEnum(DaysEnum::FRIDAY);
$day_tue2 = new DaysEnum(DaysEnum::TUESDAY);
$day_fri2 = new DaysEnum($day_fri1);

var_dump($day_tue1 == DaysEnum::TUESDAY);
var_dump($day_tue1 == $day_tue2);
var_dump($day_fri1 == $day_fri2);
var_dump($day_tue1 == DaysEnum::FRIDAY);
var_dump($day_tue1 == $day_fri1);

// Outputs:
// bool(true)
// bool(true)
// bool(true)
// bool(false)
// bool(false)
```

#### Core\\SmartCallable

[](#coresmartcallable-1)

```
// In this example we create a method which requests a web resource using curl.
// We use a SmartCallable instance to ensure the curl resource is closed when
// the method returns, or an exception is thrown.

public function fetch()
{
  $curl = curl_init("http://some-site.com");
  $sc = SmartCallable::factory(function() use($curl) {
          curl_close($curl);
  });

  $response = curl_exec($curl);
  if ($e = curl_error()) {
      throw new Exception($e);
  }

  return $response;
}

// The method could also be written this way.
public function fetch()
{
  $curl = curl_init("http://some-site.com");
  $sc = SmartCallable::factory("curl_close", $curl);

  $response = curl_exec($curl);
  if ($e = curl_error()) {
      throw new Exception($e);
  }

  return $response;
}
```

#### Core\\ConfigurableCallable

[](#coreconfigurablecallable-1)

```
// In this example you want to insert a row into the database, which may lead to
// a DeadLockException being thrown. The recommended action for dead locks is retrying
// the query. We use a ConfigurableCallable instance to keep trying the query until
// it succeeds.
$link  = mysqli_connect("localhost", "my_user", "my_password", "my_db");
$query = new ConfigurableCallable("mysqli_query");
$query->retryOnException(DeadLockException::class);
$result = $query($link, "INSERT INTO `members` ('headzoo')");

// In this example we will call a remote web API, which sometimes takes a few tries
// depending on how busy the remote server is at the any given moment. The remote
// server may return an empty value (null), the API library may thrown an exception,
// or PHP may trigger an error.
$api     = new RemoteApi();
$members = new ConfigurableCallable([$api, "getMembers"]);
$members->retryOnException()
     ->retryOnError()
     ->retryOnNull();
$rows = $members(0, 10);
```

#### Core\\Conversions

[](#coreconversions-1)

```
echo Conversions::bytesToHuman(100);
// Outputs: "100B"

echo Conversions::bytesToHuman(1024);
// Outputs: "1KB"

echo Conversions::bytesToHuman(1050);
// Outputs: "1.02KB"
```

Change Log
----------

[](#change-log)

##### v0.6.3.2 - 2014/06/24

[](#v0632---20140624)

- Change to `Objects::isInstance` handling of non-objects.

##### v0.6.3.1 - 2014/05/28

[](#v0631---20140528)

- Created `FunctionsTrait::throwOnInvalidArgument`.

##### v0.6.2 - 2014/05/19

[](#v062---20140519)

- Bug fix in `Arrays` class.

##### v0.6.1 - 2014/05/13

[](#v061---20140513)

- Minor fixes for Psr\\Log.

##### v0.6.0 - 2014/04/01

[](#v060---20140401)

- The `Functions` class is now a trait, `FunctionsTrait`.
- Renamed the class `Complete` to `SmartCallable`.
- Created the `ConfigurableCallable` class.
- Created the `Comparator` class.

##### v0.5.0 - 2014/03/31

[](#v050---20140331)

- Created the `Conversions` class.
- The `Profiler::run` method outputs memory usage.
- Refactored the `ErrorHandler` class.

##### v0.4.1 - 2014/03/30

[](#v041---20140330)

- Created the `Functions::swapArgs` method.
- Refactored some of the code in the `ErrorsHandler` class.

##### v0.4.0 - 2014/03/30

[](#v040---20140330)

- Created the `ErrorsHandler` class.
- Created the `Errors` class.
- Created the `Arrays::remove` method.

##### v0.3.2 - 2014/03/29

[](#v032---20140329)

- Created the `Strings::truncate` method.
- Removed the `Strings::split` method.
- Created the `Profiler` class.
- Made `psr/Log` a requirement.

##### v0.3.1 - 2014/03/27

[](#v031---20140327)

- Merged the `Validator` class into the `Functions` class.

##### v0.3 - 2014/03/26

[](#v03---20140326)

- Renamed the namespace `Headzoo\Utilities` to `Headzoo\Core`.
- Renamed the project `headzoo/core`.
- Created core class `Obj`.
- Added the trait `ConstantsTrait`.
- Created the `ConstantsTrait` trait.
- Created the `AbstractEnum` class.
- The `Strings` class is now made to work seamlessly with multi-byte strings.
- Renamed `Strings::transformCamelCaseToUnderscore` to `Strings::camelCaseToUnderscore`.
- Renamed `Strings::transformUnderscoreToCamelCase` to `Strings::underscoreToCamelCase`.
- Added new methods to the `Strings` class:
    - `Strings::startsWith`.
    - `Strings::endsWith`.
    - `Strings::startsUpper`.
    - `Strings::startsLower`.
    - `Strings::replace`.
    - `Strings::length`.
    - `Strings::chars`.
    - `Strings::toUpper`.
    - `Strings::toLower`.
    - `Strings::ucFirst`.
    - `Strings::lcFirst`.
    - `Strings::title`.
    - `Strings::sub`.
    - `Strings::split`.
    - `Strings::transform`.

##### v0.2.3 - 2014/03/25

[](#v023---20140325)

- Increased the minimum PHP version requirement to 5.5.0. Long live, ClassName::class!
- Added the method `Strings::quote`.
- Added the method `Arrays::conjunct`.
- Added the method `Functions::swapCallable`.
- Added the class `Validator`.

##### v0.2.2 - 2014/03/24

[](#v022---20140324)

- Added the method `Arrays::findString`.

##### v0.2.1 - 2014/03/24

[](#v021---20140324)

- Changed visibility of `Complete::invoke` to public.

##### v0.2 - 2014/03/24

[](#v02---20140324)

- Added the `Complete` class.

##### v0.1 - 2014/03/23

[](#v01---20140323)

- First version released under MIT license.

TODO
----

[](#todo)

- Replace `Strings` constants with enums.

License
-------

[](#license)

This content is released under the MIT License. See the included LICENSE for more information.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~6 days

Total

16

Last Release

4341d ago

PHP version history (2 changes)0.1PHP >=5.4.0

0.2.3PHP >=5.5.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/e0f8253561b4384888f8bbfc9ea49eb5907382bda3908bc66e9fdf776f80507f?d=identicon)[headzoo](/maintainers/headzoo)

---

Top Contributors

[![headzoo](https://avatars.githubusercontent.com/u/707209?v=4)](https://github.com/headzoo "headzoo (212 commits)")

---

Tags

phpenumutilitystringsarrays

### Embed Badge

![Health badge](/badges/headzoo-utilities/health.svg)

```
[![Health](https://phpackages.com/badges/headzoo-utilities/health.svg)](https://phpackages.com/packages/headzoo-utilities)
```

###  Alternatives

[fuwasegu/php-enum-util

The extension library for PHP native enum.

119.1k](/packages/fuwasegu-php-enum-util)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)