BladeCompiler

class BladeCompiler extends Compiler implements CompilerInterface (View source)

Traits

CompilesAuthorizations
CompilesComments
CompilesComponents
CompilesConditionals
CompilesEchos
CompilesIncludes
CompilesInjections
CompilesLayouts
CompilesLoops
CompilesRawPhp
CompilesStacks
CompilesTranslations

Properties

protected Filesystem $files The Filesystem instance. from Compiler
protected string $cachePath Get the cache path for the compiled views. from Compiler
protected string $lastSection The name of the last section that was started. from CompilesLayouts
protected int $forElseCounter Counter to keep track of nested forelse statements. from CompilesLoops
protected array $extensions All of the registered extensions.
protected array $customDirectives All custom "directive" handlers.
protected string $path The file currently being compiled.
protected array $compilers All of the available compiler functions.
protected array $rawTags Array of opening and closing tags for raw echos.
protected array $contentTags Array of opening and closing tags for regular echos.
protected array $escapedTags Array of opening and closing tags for escaped echos.
protected string $echoFormat The "regular" / legacy echo string format.
$footer Array of footer lines to be added to template.
protected string $verbatimPlaceholder Placeholder to temporary mark the position of verbatim blocks.
protected array $verbatimBlocks Array to temporary store the verbatim blocks found in the template.

Methods

void __construct(Filesystem $files, string $cachePath)

Create a new compiler instance.

from Compiler
string getCompiledPath(string $path)

Get the path to the compiled version of a view.

from Compiler
bool isExpired(string $path)

Determine if the view at the given path is expired.

from Compiler
string compileCan(string $expression)

Compile the can statements into valid PHP.

from CompilesAuthorizations
string compileCannot(string $expression)

Compile the cannot statements into valid PHP.

from CompilesAuthorizations
string compileElsecan(string $expression)

Compile the else-can statements into valid PHP.

from CompilesAuthorizations
string compileElsecannot(string $expression)

Compile the else-cannot statements into valid PHP.

from CompilesAuthorizations
string compileEndcan()

Compile the end-can statements into valid PHP.

from CompilesAuthorizations
string compileEndcannot()

Compile the end-cannot statements into valid PHP.

from CompilesAuthorizations
string compileComments(string $value)

Compile Blade comments into an empty string.

from CompilesComments
string compileComponent(string $expression)

Compile the component statements into valid PHP.

from CompilesComponents
string compileEndComponent()

Compile the end-component statements into valid PHP.

from CompilesComponents
string compileSlot(string $expression)

Compile the slot statements into valid PHP.

from CompilesComponents
string compileEndSlot()

Compile the end-slot statements into valid PHP.

from CompilesComponents
string compileHasSection(string $expression)

Compile the has-section statements into valid PHP.

from CompilesConditionals
string compileAuth(string|null $guard = null)

Compile the if-auth statements into valid PHP.

from CompilesConditionals
string compileEndAuth()

Compile the end-auth statements into valid PHP.

from CompilesConditionals
string compileGuest(string|null $guard = null)

Compile the if-guest statements into valid PHP.

from CompilesConditionals
string compileEndGuest()

Compile the end-guest statements into valid PHP.

from CompilesConditionals
string compileIf(string $expression)

Compile the if statements into valid PHP.

from CompilesConditionals
string compileUnless(string $expression)

Compile the unless statements into valid PHP.

from CompilesConditionals
string compileElseif(string $expression)

Compile the else-if statements into valid PHP.

from CompilesConditionals
string compileElse()

Compile the else statements into valid PHP.

from CompilesConditionals
string compileEndif()

Compile the end-if statements into valid PHP.

from CompilesConditionals
string compileEndunless()

Compile the end-unless statements into valid PHP.

from CompilesConditionals
string compileIsset(string $expression)

Compile the if-isset statements into valid PHP.

from CompilesConditionals
string compileEndIsset()

Compile the end-isset statements into valid PHP.

from CompilesConditionals
string compileEchos(string $value)

Compile Blade echos into valid PHP.

from CompilesEchos
array getEchoMethods()

Get the echo methods in the proper order for compilation.

from CompilesEchos
string compileRawEchos(string $value)

Compile the "raw" echo statements.

from CompilesEchos
string compileRegularEchos(string $value)

Compile the "regular" echo statements.

from CompilesEchos
string compileEscapedEchos(string $value)

Compile the escaped echo statements.

from CompilesEchos
string compileEchoDefaults(string $value)

Compile the default values for the echo statement.

from CompilesEchos
string compileEach(string $expression)

Compile the each statements into valid PHP.

from CompilesIncludes
string compileInclude(string $expression)

Compile the include statements into valid PHP.

from CompilesIncludes
string compileIncludeIf(string $expression)

Compile the include-if statements into valid PHP.

from CompilesIncludes
string compileIncludeWhen(string $expression)

Compile the include-when statements into valid PHP.

from CompilesIncludes
string compileInject(string $expression)

Compile the inject statements into valid PHP.

from CompilesInjections
string compileExtends(string $expression)

Compile the extends statements into valid PHP.

from CompilesLayouts
string compileSection(string $expression)

Compile the section statements into valid PHP.

from CompilesLayouts
string compileParent()

Replace the @parent directive to a placeholder.

from CompilesLayouts
string compileYield(string $expression)

Compile the yield statements into valid PHP.

from CompilesLayouts
string compileShow()

Compile the show statements into valid PHP.

from CompilesLayouts
string compileAppend()

Compile the append statements into valid PHP.

from CompilesLayouts
string compileOverwrite()

Compile the overwrite statements into valid PHP.

from CompilesLayouts
string compileStop()

Compile the stop statements into valid PHP.

from CompilesLayouts
string compileEndsection()

Compile the end-section statements into valid PHP.

from CompilesLayouts
string compileForelse(string $expression)

Compile the for-else statements into valid PHP.

from CompilesLoops
string compileEmpty(string $expression)

Compile the for-else-empty and empty statements into valid PHP.

from CompilesLoops
string compileEndforelse()

Compile the end-for-else statements into valid PHP.

from CompilesLoops
string compileEndEmpty()

Compile the end-empty statements into valid PHP.

from CompilesLoops
string compileFor(string $expression)

Compile the for statements into valid PHP.

from CompilesLoops
string compileForeach(string $expression)

Compile the for-each statements into valid PHP.

from CompilesLoops
string compileBreak(string $expression)

Compile the break statements into valid PHP.

from CompilesLoops
string compileContinue(string $expression)

Compile the continue statements into valid PHP.

from CompilesLoops
string compileEndfor()

Compile the end-for statements into valid PHP.

from CompilesLoops
string compileEndforeach()

Compile the end-for-each statements into valid PHP.

from CompilesLoops
string compileWhile(string $expression)

Compile the while statements into valid PHP.

from CompilesLoops
string compileEndwhile()

Compile the end-while statements into valid PHP.

from CompilesLoops
string compilePhp(string $expression)

Compile the raw PHP statements into valid PHP.

from CompilesRawPhp
string compileEndphp()

Compile end-php statements into valid PHP.

from CompilesRawPhp
string compileUnset(string $expression)

Compile the unset statements into valid PHP.

from CompilesRawPhp
string compileStack(string $expression)

Compile the stack statements into the content.

from CompilesStacks
string compilePush(string $expression)

Compile the push statements into valid PHP.

from CompilesStacks
string compileEndpush()

Compile the end-push statements into valid PHP.

from CompilesStacks
string compilePrepend(string $expression)

Compile the prepend statements into valid PHP.

from CompilesStacks
string compileEndprepend()

Compile the end-prepend statements into valid PHP.

from CompilesStacks
string compileLang(string $expression)

Compile the lang statements into valid PHP.

from CompilesTranslations
string compileEndlang()

Compile the end-lang statements into valid PHP.

from CompilesTranslations
string compileChoice(string $expression)

Compile the choice statements into valid PHP.

from CompilesTranslations
void compile(string $path = null)

Compile the view at the given path.

string getPath()

Get the path currently being compiled.

void setPath(string $path)

Set the path currently being compiled.

string compileString(string $value)

Compile the given Blade template contents.

string storeVerbatimBlocks(string $value)

Store the verbatim blocks and replace them with a temporary placeholder.

string restoreVerbatimBlocks(string $result)

Replace the raw placeholders with the original code stored in the raw blocks.

string addFooters(string $result)

Add the stored footers onto the given content.

string parseToken(array $token)

Parse the tokens from the template.

string compileExtensions(string $value)

Execute the user defined extensions.

string compileStatements(string $value)

Compile Blade statements that start with "@".

string compileStatement(array $match)

Compile a single Blade @ statement.

string callCustomDirective(string $name, string|null $value)

Call the given directive with the given value.

string stripParentheses(string $expression)

Strip the parentheses from the given expression.

void extend(callable $compiler)

Register a custom Blade compiler.

array getExtensions()

Get the extensions used by the compiler.

void directive(string $name, callable $handler)

Register a handler for custom directives.

array getCustomDirectives()

Get the list of custom directives.

void setEchoFormat(string $format)

Set the echo format to be used by the compiler.

Details

void __construct(Filesystem $files, string $cachePath)

Create a new compiler instance.

Parameters

Filesystem $files
string $cachePath

Return Value

void

Exceptions

InvalidArgumentException

string getCompiledPath(string $path)

Get the path to the compiled version of a view.

Parameters

string $path

Return Value

string

bool isExpired(string $path)

Determine if the view at the given path is expired.

Parameters

string $path

Return Value

bool

protected string compileCan(string $expression)

Compile the can statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileCannot(string $expression)

Compile the cannot statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileElsecan(string $expression)

Compile the else-can statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileElsecannot(string $expression)

Compile the else-cannot statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndcan()

Compile the end-can statements into valid PHP.

Return Value

string

protected string compileEndcannot()

Compile the end-cannot statements into valid PHP.

Return Value

string

protected string compileComments(string $value)

Compile Blade comments into an empty string.

Parameters

string $value

Return Value

string

protected string compileComponent(string $expression)

Compile the component statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndComponent()

Compile the end-component statements into valid PHP.

Return Value

string

protected string compileSlot(string $expression)

Compile the slot statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndSlot()

Compile the end-slot statements into valid PHP.

Return Value

string

protected string compileHasSection(string $expression)

Compile the has-section statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileAuth(string|null $guard = null)

Compile the if-auth statements into valid PHP.

Parameters

string|null $guard

Return Value

string

protected string compileEndAuth()

Compile the end-auth statements into valid PHP.

Return Value

string

protected string compileGuest(string|null $guard = null)

Compile the if-guest statements into valid PHP.

Parameters

string|null $guard

Return Value

string

protected string compileEndGuest()

Compile the end-guest statements into valid PHP.

Return Value

string

protected string compileIf(string $expression)

Compile the if statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileUnless(string $expression)

Compile the unless statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileElseif(string $expression)

Compile the else-if statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileElse()

Compile the else statements into valid PHP.

Return Value

string

protected string compileEndif()

Compile the end-if statements into valid PHP.

Return Value

string

protected string compileEndunless()

Compile the end-unless statements into valid PHP.

Return Value

string

protected string compileIsset(string $expression)

Compile the if-isset statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndIsset()

Compile the end-isset statements into valid PHP.

Return Value

string

protected string compileEchos(string $value)

Compile Blade echos into valid PHP.

Parameters

string $value

Return Value

string

protected array getEchoMethods()

Get the echo methods in the proper order for compilation.

Return Value

array

protected string compileRawEchos(string $value)

Compile the "raw" echo statements.

Parameters

string $value

Return Value

string

protected string compileRegularEchos(string $value)

Compile the "regular" echo statements.

Parameters

string $value

Return Value

string

protected string compileEscapedEchos(string $value)

Compile the escaped echo statements.

Parameters

string $value

Return Value

string

string compileEchoDefaults(string $value)

Compile the default values for the echo statement.

Parameters

string $value

Return Value

string

protected string compileEach(string $expression)

Compile the each statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileInclude(string $expression)

Compile the include statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileIncludeIf(string $expression)

Compile the include-if statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileIncludeWhen(string $expression)

Compile the include-when statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileInject(string $expression)

Compile the inject statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileExtends(string $expression)

Compile the extends statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileSection(string $expression)

Compile the section statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileParent()

Replace the @parent directive to a placeholder.

Return Value

string

protected string compileYield(string $expression)

Compile the yield statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileShow()

Compile the show statements into valid PHP.

Return Value

string

protected string compileAppend()

Compile the append statements into valid PHP.

Return Value

string

protected string compileOverwrite()

Compile the overwrite statements into valid PHP.

Return Value

string

protected string compileStop()

Compile the stop statements into valid PHP.

Return Value

string

protected string compileEndsection()

Compile the end-section statements into valid PHP.

Return Value

string

protected string compileForelse(string $expression)

Compile the for-else statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEmpty(string $expression)

Compile the for-else-empty and empty statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndforelse()

Compile the end-for-else statements into valid PHP.

Return Value

string

protected string compileEndEmpty()

Compile the end-empty statements into valid PHP.

Return Value

string

protected string compileFor(string $expression)

Compile the for statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileForeach(string $expression)

Compile the for-each statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileBreak(string $expression)

Compile the break statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileContinue(string $expression)

Compile the continue statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndfor()

Compile the end-for statements into valid PHP.

Return Value

string

protected string compileEndforeach()

Compile the end-for-each statements into valid PHP.

Return Value

string

protected string compileWhile(string $expression)

Compile the while statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndwhile()

Compile the end-while statements into valid PHP.

Return Value

string

protected string compilePhp(string $expression)

Compile the raw PHP statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndphp()

Compile end-php statements into valid PHP.

Return Value

string

protected string compileUnset(string $expression)

Compile the unset statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileStack(string $expression)

Compile the stack statements into the content.

Parameters

string $expression

Return Value

string

protected string compilePush(string $expression)

Compile the push statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndpush()

Compile the end-push statements into valid PHP.

Return Value

string

protected string compilePrepend(string $expression)

Compile the prepend statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndprepend()

Compile the end-prepend statements into valid PHP.

Return Value

string

protected string compileLang(string $expression)

Compile the lang statements into valid PHP.

Parameters

string $expression

Return Value

string

protected string compileEndlang()

Compile the end-lang statements into valid PHP.

Return Value

string

protected string compileChoice(string $expression)

Compile the choice statements into valid PHP.

Parameters

string $expression

Return Value

string

void compile(string $path = null)

Compile the view at the given path.

Parameters

string $path

Return Value

void

string getPath()

Get the path currently being compiled.

Return Value

string

void setPath(string $path)

Set the path currently being compiled.

Parameters

string $path

Return Value

void

string compileString(string $value)

Compile the given Blade template contents.

Parameters

string $value

Return Value

string

protected string storeVerbatimBlocks(string $value)

Store the verbatim blocks and replace them with a temporary placeholder.

Parameters

string $value

Return Value

string

protected string restoreVerbatimBlocks(string $result)

Replace the raw placeholders with the original code stored in the raw blocks.

Parameters

string $result

Return Value

string

protected string addFooters(string $result)

Add the stored footers onto the given content.

Parameters

string $result

Return Value

string

protected string parseToken(array $token)

Parse the tokens from the template.

Parameters

array $token

Return Value

string

protected string compileExtensions(string $value)

Execute the user defined extensions.

Parameters

string $value

Return Value

string

protected string compileStatements(string $value)

Compile Blade statements that start with "@".

Parameters

string $value

Return Value

string

protected string compileStatement(array $match)

Compile a single Blade @ statement.

Parameters

array $match

Return Value

string

protected string callCustomDirective(string $name, string|null $value)

Call the given directive with the given value.

Parameters

string $name
string|null $value

Return Value

string

string stripParentheses(string $expression)

Strip the parentheses from the given expression.

Parameters

string $expression

Return Value

string

void extend(callable $compiler)

Register a custom Blade compiler.

Parameters

callable $compiler

Return Value

void

array getExtensions()

Get the extensions used by the compiler.

Return Value

array

void directive(string $name, callable $handler)

Register a handler for custom directives.

Parameters

string $name
callable $handler

Return Value

void

array getCustomDirectives()

Get the list of custom directives.

Return Value

array

void setEchoFormat(string $format)

Set the echo format to be used by the compiler.

Parameters

string $format

Return Value

void

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.4/Illuminate/View/Compilers/BladeCompiler.html