Download the PHP package oihana/php-core without Composer

Oihana PHP - Core library

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

Table of Contents

• ✨ Core Packages
• 📚 Documentation
• 📦️ Installation
• 💡 Features
• 🚀 Quick Start
• 🧪 Examples
• ✅ Running Unit Tests
• 🤝 Contributing
• 🧾 License
• 👤 About the author

Core Packages

The library provides a suite of pure, side-effect-free utility functions organized into logical namespaces. Here’s a summary of what each package offers:

Documentation

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

• Changelog: CHANGELOG.md
• License: MPL-2.0

Installation

Requires PHP 8.4+

Install via Composer:

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()

🔢 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()
• now()

📄 Documents (oihana\core\documents)

Template and placeholder resolution:

• formatDocument()
• resolvePlaceholders()

💻 Env (oihana\core\env)

Environment detection helpers:

• OS detection: isLinux(), isMac(), isWindows()
• Environment type: isCli(), isWeb(), isDocker()
• PHP info: phpVersion(), isExtensionLoaded()

🧬 JSON (oihana\core\json)

Advanced JSON utilities:

• deepJsonSerialize()
• isValidJsonEncodeFlags(), isValidJsonDecodeFlags()

➗ Maths (oihana\core\maths)

Smart numeric rounding helpers:

• ceilValue(), floorValue(), roundValue()
• Float noise: shedFloatNoise() — sheds the binary noise of a computed figure by significant digits, never a business rounding ; scale: reckons them on the largest term of a sum whose terms cancel
• Geolocation: haversine(), bearing()

🔢 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
• toAssociativeArray()

⚙️ Reflections (oihana\core\reflections)

• Function analysis: 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 (oihana\core)

General-purpose helpers:

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

Quick Start

Most helpers are loaded via Composer autoload. You can import functions directly using use function and call them.

Examples

Accessors: work with arrays and objects

Arrays: reading and transforming

Strings: formatting and cases

Objects: cleaning data

Date: formatting

Numbers: clamping a value

Running Unit Tests

To run all tests:

To run a specific test file:

Static Analysis (PHPStan)

The library is analysed with PHPStan at the strictest level (max). The configuration lives in phpstan.neon.

Findings that pre-date the introduction of static analysis are frozen in phpstan-baseline.neon, so the command is green and only reports new issues — keeping every future change held to the max bar. The goal is to shrink the baseline over time: once you legitimately fix some of its entries, regenerate it with

PHPStan does not need Xdebug and is independent from the test suite.

Contributing

Contributions are welcome! Whether you're fixing a bug, improving an existing feature, or proposing a new one, your help is appreciated.

Please feel free to:

• Report a bug: If you find a bug, please open an issue and provide as much detail as possible.
• Suggest an enhancement: Have an idea to make this library better? Open an issue to discuss it.
• Submit a pull request: Fork the repository, make your changes, and open a pull request. Please ensure all tests are passing before submitting.

You can find the issues page here: https://github.com/BcommeBois/oihana-php-core/issues

License

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

About the author

• Author : Marc ALCARAZ (aka eKameleon)
• Mail : [email protected]
• Website : http://www.ooop.fr