oihana/php-core

The Oihana PHP Core library

Maintainers

Details

github.com/BcommeBois/oihana-php-core

Homepage

Source

Issues

Installs: 130

Dependents: 4

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

1.0.5 2025-07-10 08:08 UTC

Requires

Requires (Dev)

MPL-2.0 0bcc580ff2428f35f6a59260c59b0dd8f30a0a6a

phpcore

This package is auto-updated.

Last update: 2025-07-28 12:00:26 UTC

README

Oihana Php Core

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:

🧾 Accessors (oihana\core\accessors)

Unified access for both arrays and objects:

  • Read: getKeyValue()
  • Write: setKeyValue()
  • Delete: deleteKeyValue() (supports wildcards: , foo.bar.)
  • Exists: hasKeyValue()
  • Validation and traversal: assertDocumentKeyValid(), resolveReferencePath()

Designed for safely accessing and modifying deep nested structures with dot notation support and automatic path creation.

🔢 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