PHPackages                             gp/loader - 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. gp/loader

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

gp/loader
=========

A Loader library to autoload the classes and a container to support the dependency injections

2.0.12(11mo ago)0663[2 issues](https://github.com/periyandavar/gp_loader/issues)5MITPHPPHP ^8.1CI passing

Since Mar 15Pushed 11mo agoCompare

[ Source](https://github.com/periyandavar/gp_loader)[ Packagist](https://packagist.org/packages/gp/loader)[ RSS](/packages/gp-loader/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (28)Used By (5)

GP Loader
=========

[](#gp-loader)

The GP Loader package provides a configuration and dependency loading framework for PHP. It is designed for managing configurations from various sources, dependency injection, and loading of application components.

Table of Contents
-----------------

[](#table-of-contents)

- [Requirements](#requirements)
- [Installation](#installation)
- [Getting Started](#getting-started)
- [Features](#features)
- [Classes](#classes)
    - [ConfigLoader](#configloader)
    - [ArrayLoader](#arrayloader)
    - [EnvLoader](#envloader)
    - [ValueLoader](#valueloader)
    - [Container](#container)
    - [Loader](#loader)
- [Usage](#usage)
    - [LoadingConfiguration](#loading-configuration)
    - [DependencyInjection](#dependency-injection)
    - [ServiceContainer](#service-container)
    - [AutoLoadingClasses](#autoloading-classes)
- [Contributing](#contributing)
- [License](#license)
- [Author](#author)
- [Contact](#contact)

---

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

[](#requirements)

- PHP 8.1 or higher
- composer

---

Installation
------------

[](#installation)

You can install `gp_loader` using Composer. Run the following command in your terminal:

```
composer require gp/loader

```

---

Getting Started
---------------

[](#getting-started)

After installation, you can start using the package by including the autoloader:

```
require 'vendor/autoload.php';

```

---

Features
--------

[](#features)

- **Flexible Configuration Loading**:

    - Supports loading configurations from multiple sources, including `.env` files, PHP arrays, Json, Xml, Yaml and direct values.
    - Easy merging, overriding, and retrieval of configuration data.
- **Easily load the Configuration from any files**

    - Load the config from any files .env, .json, .yaml, .php
    - Access it anywhere in your application
    - Eassy to load and manage
- **Dependency Injection Container**:

    - Manage services and instances with a built-in DI container.
    - Supports singleton services and dynamic resolution of dependencies.
    - Simplifies service management with the `loadFromConfig` method.
- **Autoloading Classes**:

    - Automatically load classes based on namespace and path configurations.
    - Supports dynamic resolution of controllers and other components.
- **Extensible Design**:

    - Abstract classes like `ConfigLoader` provide the foundation for implementing custom loaders.
    - Easily extend functionality to support additional data sources or custom behaviors.
- **Environment Variable Integration**:

    - Load environment variables directly from `.env` files.
    - Simplifies managing sensitive configuration data.
- **Lightweight and Modular**:

    - Designed to be lightweight and modular, making it easy to integrate into any PHP project.
    - Provides only essential functionality without unnecessary overhead.
- **Error Handling and Validation**:

    - Includes methods for safely retrieving, setting, and overriding configuration values.
    - Ensures proper resolution of constructor dependencies and method calls.
- **Dynamic Service Resolution**:

    - Resolve services dynamically via `Container::resolve` and `Container::resolveMethod`.
    - Allows for flexible service binding and retrieval.
- **Factory-Based Loader Instantiation**:

    - Use `ConfigLoader::getInstance` to dynamically instantiate loaders based on the required type (e.g., `ENV_LOADER`, `ARRAY_LOADER`).

These features make the GP Loader framework powerful, extensible, and easy to use for managing configurations and dependencies in PHP applications.

---

Classes
-------

[](#classes)

### ConfigLoader

[](#configloader)

An abstract class that acts as the base for configuration loaders. It defines the common methods and structure for loading configurations from various sources.

#### Methods

[](#methods)

- `load()`: Loads the configuration data using the `innerLoader` method and sets up the load handler.
- `get(string $key)`: Retrieves a configuration value by its key.
- `getAll()`: Returns all configuration data.
- `merge(array $data)`: Merges additional data into the existing configuration.
- `set(string $key, $value, bool $strict = false)`: Sets a specific configuration value.
- `override(array $data)`: Overrides the current configuration with new data.
- `setLoadHandler(callable $_loadHandler)`: Sets a custom handler to process the loaded data.
- `defaultHandler($data)`: Default handler to load configuration values into environment variables.
- `getInstance($driver, $config = [], $name = '')`: Factory method to create an instance of a specific loader.
- `getConfig(string $name)`: Retrieves a named configuration instance.
- `loadConfig(string $file, string $name = '')`: Load the configs directly from the file.
- `getFile()`: Returns the file.

#### Constants

[](#constants)

- `ENV_LOADER`: Represents the environment file loader.
- `ARRAY_LOADER`: Represents the array-based php file loader.
- `XML_LOADER` : Represents the XML file loader.
- `YAML_LOADER`: Represents the YAML file loader.
- `JSON_LOADER` : Represents the JSON file loader.
- `VALUE_LOADER`: Represents the value-based loader.

---

### Container

[](#container)

A dependency injection container for managing instances and services.

#### Methods

[](#methods-1)

- `set(string $_name, mixed $_closure, bool $_singleton = false)`: Registers an instance or service.
- `getInstance(string $_name)`: Retrieves a singleton instance.
- `getService(string $_name)`: Retrieves a service.
- `get(string $_name)`: Retrieves an object from the container.
- `isClassRegistered(string $_name)`: Checks if a class is registered.
- `resolve(string $_class_name, array $data = [])`: Resolves and creates an instance of a class.
- `getConstrParams(string $_class_name, $data)`: Resolves constructor dependencies for a class.
- `loadFromConfig(array $_config)`: Loads configuration and registers services.
- `resolveMethod(string $class, string $method, array $data)`: Resolves dependencies for a specific method.
- `resolveClassConstructor(string $class, array $params = [])`: Resolves the constructor dependencies of a class and creates an instance.
- `resolveClassMethod($class, string $method, array $params = [])`: Resolves the dependencies for a specific method of a class and invokes it.

---

### Loader

[](#loader)

A class responsible for managing the loading of application components.

#### Methods

[](#methods-2)

- `autoLoadClass($ctrl, $autoloads, ?ConfigLoader $config = null)`: Automatically loads classes based on the configuration.
- `setPrefixes(array $prefixes)`: Sets the prefixes for autoloading classes.

---

Usage
-----

[](#usage)

### Load the config from file.

[](#load-the-config-from-file)

Load the configuration directly from the file.

```
use Loader\Config\ConfigLoader;

$config = ConfigLoader::loadConfig(__DIR__ . 'test.xml', 'xml_config);

$config_values = $config->getAll();
print_r($config_values);

// to load the created config by name.
$config = ConfigLoader::getConfig('xml_config');

$config_values = $config->getAll();
print_r($config_values);

```

### Loading Configuration

[](#loading-configuration)

You can load configurations using the `ConfigLoader` factory method:

```

use Loader\Config\ConfigLoader;

$config = ConfigLoader::getInstance(ConfigLoader::ENV_LOADER, ['file' => '.env']); $config->load();
echo $config->get('APP_ENV');

```

### Dependency Injection

[](#dependency-injection)

Use the `Container` class to manage services and resolve dependencies:

```
use Loader\Container;

Container::set('db', function() {
    return new DatabaseConnection();
}, true);

$db = Container::get('db');

```

### Service Container

[](#service-container)

```
// Example configuration array for services
$config = [
    'services' => [
        'db' => [
            'class' => DatabaseConnection::class,
            'params' => [
                'host' => 'localhost',
                'username' => 'root',
                'password' => '',
                'database' => 'example_db',
            ],
            'singleton' => true
        ],
        'cache' => [
            'class' => CacheService::class,
            'params' => [
                'cache_dir' => '/tmp'
            ]
        ]
    ]
];

// Load configuration into the container
Container::loadFromConfig($config);

// Usage example: Get the database connection instance
$db = Container::get('db');
$db->connect();

// Usage example: Get the cache service
$cache = Container::get('cache');
$cache->save('key', 'value');

```

### Autoloading Classes

[](#autoloading-classes)

The `Loader` class can manage the loading of components, and make its available to your class object

```
use Loader\Loader;

$service = new Service(); // your custom service class
$autoloads = [
    'cache' => Cache::class,
    'db' => DB::class
];
$loader = Loader::autoLoadClass($service, $autoloads);

$service->db->getConnection(); // you can access the db class object directly in the service class object dynamically.
$service->cache->set('name', 'value'); // you can access the cache class object directly in the service class object dynamically.

```

---

### Contributing

[](#contributing)

Contributions are welcome! If you would like to contribute to gp\_validator, please follow these steps:

- Fork the repository.
- Create a new branch (git checkout -b feature/- YourFeature).
- Make your changes and commit them (git commit -m 'Add some feature').
- Push to the branch (git push origin feature/YourFeature).
- Open a pull request.
- Please ensure that your code adheres to the coding standards and includes appropriate tests.

---

License
-------

[](#license)

This package is licensed under the MIT License. See the [LICENSE](https://github.com/periyandavar/gp_loader/blob/main/LICENSE) file for more information.

---

Contact
-------

[](#contact)

For questions or issues, please reach out to the development team or open a ticket.

---

Author
------

[](#author)

- Periyandavar [Github](https://github.com/periyandavar) ()

---

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance50

Moderate activity, may be stable

Popularity13

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.6% 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 ~4 days

Total

20

Last Release

352d ago

Major Versions

v1.2.0 → v2.0.02025-04-26

PHP version history (2 changes)v1.2.0PHP ^8.0

v2.0.0PHP ^8.1

### Community

Maintainers

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

---

Top Contributors

[![periyandavar](https://avatars.githubusercontent.com/u/209335631?v=4)](https://github.com/periyandavar "periyandavar (122 commits)")[![periyandavar-gp](https://avatars.githubusercontent.com/u/209334761?v=4)](https://github.com/periyandavar-gp "periyandavar-gp (3 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gp-loader/health.svg)

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

###  Alternatives

[orchestra/canvas

Code Generators for Laravel Applications and Packages

21017.2M158](/packages/orchestra-canvas)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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