Download the PHP package axy/nginx-config-syntax without Composer

axy\nginx\config\syntax

Builds a file with syntax similar to nginx config. Nginx-specific directives are implemented in a separate package.

Structure

• There is a "context" on the top level
• Context contains list of items
• An item can be "directive" or "comment"
• There are two type of directives: single and block
• A directive of any type has "name" and list of parameters (can be empty, a parameter is a string)
• A block directive has nested context
• Nested context contains list of items, etc. The number of levels is not limited

Syntax

Example

Result is the text from "syntax" section.

Class hierarchy

• BaseItem
  • BaseContext
    • Context
      • DirectiveContext
  • BaseDirective
    • SingleDirective
      • CustomSingleDirective
    • BlockDirective
      • CustomBlockDirective
• Comment

Context

A context has the public array $items. When a context is rendering it renders all items in order.

An item can be any value (object or scalar) that can be cast to a string.

An item is rendered on a separate line (or several lines) with indentation of the current context. If a scalar item converts to empty line it will take one empty line in the output. If an object item converts to empty line it will take no lines.

Methods and properties:

• Can work with the $items array directly
• append($item): void - appends an item to the array
• single($name [, $params]): CustomSingleDirective - helper for easy creation of a single directive (see below). Creates, appends and returns.
• block($name [, $params]): CustomBlockDirective - helper for block directive creation

Directives

CustomSingleDirective and CustomBlockDirective used for easy creation directives. They take as arguments in the constructor:

• $name (string) - the directive name
• $params - list of parameters
  • available as public property and can be changed afterwards
  • NULL - no params
  • string - displayed as is (without escaping)
  • string[] - list of parameters, escaped and imploded
    • escaped spaces and quoted
    • not sure if this is correct

Base classes SingleDirective and BlockDirective are used as parent for specific directive classes.

Block directive context

BlockDirective has the public property $context.

Result:

There are $topContext and $mainContext (protected) also. They are appended to $context automatically. Usually it is enough to use $context only.

But a specific directive class should write its content to the $mainContext. If the user want to add custom directives they can use $context->appned() (append to the bottom) or $topContext->append().

Disable directive

All directive objects is enabled by default. But can be disabled and will not be displayed.

• isEnabled(): bool
• enable(): void
• disable(): void

Comment

All directive and context objects have the public property comment.

Result:

set() can take:

• string - the comment content, can be multiline
• string[] - will be imploded
• NULL - no comment (by default)
• delete() is alias for set(null)

Can set comment for a block directive and for its context:

Result:

Render

All BaseItem implement __toString(), but there are nuances:

• There may be trailing spaces
• Tabs are used for indentation (one tab per nested level)
• "\n" for line breaks

For formatting on the top level can be used render() method. Arguments:

• $indent (string, 4 spaces by default) - replaces tabs
• $clear (bool, FALSE by default) - deletes comment lines and empty lines
• $rtrim (bool, TRUE by default) - deletes tailing spaces, empty lines at the end and ends the file by one blank line
• $nl (string, "\n" by default) - line break symbol