Download the PHP package pollen-solutions/skeleton without Composer

Skeleton Component

Skeleton Component provides structures of standalone project based on Pollen Solutions suite.

Table of contents

• Features
• Installation
  • Standard installation
  • Docker installation
• Configuration
  • Environment configuration
  • Customize a local environment configuration
  • Environment Variable Types
  • Environment variable mapping
  • Use application variable
• Directory structure
  • The Root directory structure
  • The Root directory details

Features

The Pollen solutions Skeleton component embeds :

• Composer, as package manager for PHP libraries.
• ViteJS as assets bundler and responsible for compiling, transpilating, versioning, optimizing ...
• Pollen solutions components suite that includes :
  • A dependency injection container
  • A routing system
  • A templating library
  • An asset manager and injector
  • An expandable command line interface
  • An event manager
  • ...
• A preconfigured Docker environment integrating :
  • A light-weight command-line interface for interact with Docker easily
  • A PHP server that run through Apache
  • A MySQL server
  • An email previewer service (MailHog)
  • A sharing local application service
  • ...
• ... And a lot of other kinds of magic !

To try it is already to contribute, you are welcome !

Installation

Standard installation

Prerequisite

• PHP must be installed on your machine see details.
• Composer must be installed on your machine see details.

Launch installation

Serve the app

Serve your application using the built-in web server in PHP (or your server of choice) from the directory:

Visit the application in the browser:

• http://127.0.0.1:8000

Docker installation

Prerequisite

• Docker must be installed on your machine see details

Launch installation

Launch application builder

Visit the application in the browser:

• http://127.0.0.1:8000

Retrieve More details about docker usage in a Pollen application from the built-in documentation.

Configuration

Environment configuration

During the installation process, the file is copied to . This file contains all required default configuration.

Customize a local environment configuration

To customize your application configuration, you can directly edit the file, but the best practice is to create a new file that will contain all the configuration attributes specific to your installation. Through the file you can if necessary override an environment value declared in the file or define new ones :

Environment variables types

Environment variable mapping

You can use another existing global or previously defined environment variable like this :

Note that, for security reasons, global environnement variables couldn't be overridden.

Use application variable

In some special cases, you may need to access application variable to complete the configuration of your environment variables and the merge vars could help you.

The paths of the application are natively available :

• : Absolute path to the root directory of the app.

• : Absolute path to the public directory of the app.

Example of usage :

Pollen solutions suite uses the vlucas/phpdotenv library to work. More information on its github repository.

Directory structure

The Skeleton component is a micro-framework. Like other solutions of this type, it is opinionated and its directory structure is intended to provide a starting point for creating a complete web application.

The Root directory structure

The Root directory details

src

The directory contains the core PHP code of your application.

resources

The directory contains the templating code. This included views and css, js, fonts, images and all other assets files.

public

The directory contains the index.php file, which is the entry point for all requests entering your application and configures autoload.

This directory also houses the build assets such css, js, fonts, images and all other assets files.

config

The directory, as the name implies, contains all of your application's PHP configuration files.

docs

The directory contains the complete documentation of the micro framework and its components. Work in progress ;)