README

A lightweight and modular core library for modern PHP development. Designed for clarity, extensibility, and performance, with a consistent, functional-style API.

📚 Documentation

Full project documentation is available at: 👉 https://bcommebois.github.io/oihana-php-core

Installation

Requires PHP 8.4+

Install via Composer:

composer require oihana/php-core

✨ Features

The oihana/php-core library provides pure utility functions (no side effects), organized into logical, reusable packages:

🔢 Arrays (oihana\core\arrays)

Advanced array utilities:

• Access and mutation: get(), set(), delete(), exists()
• Transformations: flatten(), tail(), unique(), shuffle(), swap(), toArray(), stub()
• Structure detection: isIndexed(), hasIntKeys(), hasStringKeys()

📅 Date (oihana\core\date)

Date manipulation and validation :

• formatDateTime()
• isDate(), isValidTimezone()

➗ Maths (oihana\core\maths)

Smart numeric rounding helpers:

• ceilValue(), floorValue(), roundValue()

🔢 Numbers (oihana\core\numbers)

• Range clamping: clip()

🧱 Objects (oihana\core\objects)

Lightweight object manipulation:

• compress() — remove null/empty values
• set() — deep set a value in a nested structure

🧠 Reflections (oihana\core\reflections)

Introspect callable/function definitions:

• getFunctionInfo()

✍️ Strings (oihana\core\strings)

String formatting, case conversions, and utilities:

• Case & slug:
• camel(), snake(), kebab(), hyphenate(), lower(), latinize()
• Format & identifiers:
• fastFormat(), formatRequestArgs(), urlencode(), toString()
• Validation:
• isRegexp(), luhn()
• Random generation:
• randomKey()

⚙️ Utils

• ifNull() — return a fallback if a value is null

✅ Running Unit Tests

To run all tests:

composer run-script test

To run a specific test file:

composer run test ./tests/oihana/core/arrays/FlattenTest.php

🧾 Licence

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0).

👤 About the author

• Author : Marc ALCARAZ (aka eKameleon)
• Mail : marc@ooop.fr
• Website : http://www.ooop.fr