Fusion - PHP Package Manager

Build Methods

Nested Dependency

To build this package as a nested dependency of your package, add its default registry source valvoid.com/valvoid/fusion/1.0.3 to one of your metadata files. For example, you can include it in the production fusion.json file, such as:

{
    "name": "Package",
    "description": "An example source package.",
    "id": "source/package",
    "version": "0.1.0",
    "structure": {
        "/cache": "cache",
        "/dependencies": [
            "valvoid.com/valvoid/fusion/1.0.3"
        ]
    },
    "environment": {
        "php": {
            "version": "8.1.0"
        }
    }
}

Standalone

To build this package as an independent root package, extend the build command with the default registry source valvoid.com/valvoid/fusion/1.0.3 as follows:

fusion build build.source=valvoid.com/valvoid/fusion/1.0.3

Optional Repository Source

In addition, to build an offset reference version, replace the default registry source in installation methods mentioned above with the VCS source prefix gitlab.com/valvoid/fusion/'php/'code/, and refer to the linked source code repository for possible branches, commits, and tags to use as the suffix.

Metadata

The synchronized package's metadata file, fusion.json, contains the following content:

{
    "name": "Fusion",
    "description": "A package manager for PHP-based projects.",
    "id": "valvoid/fusion",
    "version": "1.0.3",
    "structure": {
        "valvoid.com/valvoid": "fusion/1.0.0",
        "/cache": "cache",
        "/extensions": {
            "/config": "extension",
            "/src": "extension"
        }
    },
    "environment": {
        "php": {
            "version": "8.1.0",
            "modules": [
                "curl"
            ]
        }
    }
}

Readme

Fusion is a PHP package manager that enhances productivity in PHP-based projects. It simplifies development and maintenance by automating repetitive micromanagement tasks, such as:

• Managing package dependencies.
• Migrating package states.
• Handling autoloadable code.

Documentation

The separated documentation repository also has the user-friendly output and contains content such as:

Architecture

The architectural approach is partly based on graph theory, where everything is an abstract nth graph vertex. In this context, each vertex is a modular package node. Your current project, each of its dependencies, and even the package manager itself, everything is a modular package node.

Since all these nodes are arbitrary linkable to each other and to themselves, among others, the following automated key features are possible:

• Nested and standalone package logic at the same time.
• Recursive project updates/upgrades.
• Common top-down stackable package extensions.
  • Even recursive.
• Separated environment builds.

Integration

As mentioned above, Fusion is also a package itself, and in addition, it provides the interface-based config for custom implementations, such as:

• Management logic.
  • Replace the default download or build implementation.
• Remote and local package hubs.
  • Add own registry.
• Log serializers.
  • Get whatever you implement output.

Configure, extend, customize, use as a dependency or standalone, Fusion is easy to integrate and adapts seamlessly.

Registry

For default packages, see the default registry page.

Contribution

Each merge request serves as confirmation to transfer ownership to the project and must meet the following criteria:

• Own intellectual property.
• Neutral content. Free from political bias, for example.
• Pure PHP without exotic extensions.

See the contributing file if these criteria apply to you.

License

Fusion. A package manager for PHP-based projects.
Copyright Valvoid

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see licenses.