Download the PHP package novatorius/blueprint without Composer
On this page you can find all versions of the php package novatorius/blueprint. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download novatorius/blueprint
More information about novatorius/blueprint
Files in novatorius/blueprint
Package blueprint
Short Description Dynamically replaces placeholders within a template string
License MIT
Homepage https://github.com/novatorius/blueprint
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package blueprint
Blueprint
A PHP library for dynamically replacing placeholders within a template string. This package processes text templates by allowing developers to define multiple sets of placeholders, each with specific start and end delimiters and associated values.
Table of Contents
- Introduction
- What is a Blueprint?
- Installation
- Usage
- Creating a Placeholder Definition
- Processing Placeholder Definitions
- License
Introduction
When working with dynamic content, it's often necessary to define placeholders in a template string and replace them with real values based on specific rules. This library enables the use of a flexible, reusable structure for replacing placeholders, making template customization intuitive and efficient.
This library supports both a basic replacement method for long templates and a more efficient scanning method for short templates, allowing it to adapt based on performance needs.
What is a Blueprint?
In this library, a "blueprint" refers to a template string containing placeholders that follow specific start and end delimiters. These placeholders are substituted with values according to PlaceholderDefinition instances.
The BlueprintProcessor processes each placeholder definition, replacing placeholders until the entire blueprint is complete. This approach supports nested or recursive replacements by re-processing the blueprint until no further changes occur.
Installation
You can install this package via Composer:
Usage
This library uses two primary classes:
- BlueprintProcessor: Manages the placeholder processing for a given template.
- PlaceholderDefinition: Defines a set of placeholders with specific delimiters and values.
Creating a Placeholder Definition
The PlaceholderDefinition class defines:
- A starting delimiter
- An ending delimiter
- An associative array of placeholder values
Processing Placeholder Definitions
Once you've created placeholder definitions, you can process them with BlueprintProcessor. This fluent interface allows you to chain multiple definitions for successive replacement.
For multiple definitions, processDefinitions can be called in sequence:
BlueprintProcessor implements PHP's __toString magic method,
so it can be automatically cast into a string, as well.
