Psr2 Code Generator

PhpInterface extends AbstractPhpStruct implements GenerateableInterface, ConstantsInterface Uses ConstantsPart, InterfacesPart

Represents a PHP interface.

Tags
author

Thomas Gossmann

psalm-suppress

PropertyNotSetInConstructor

Interfaces, Classes and Traits

GenerateableInterface
Represents all models that can be generated with a code generator.
ConstantsInterface
Interface to all php structs that can have constants.

Table of Contents

$description  : string
$constants  : Map
$docblock  : Docblock
$interfaces  : Set
$longDescription  : string
$methods  : Map
$namespace  : string
$requiredFiles  : Set
$useStatements  : Map
__construct()  : mixed
Create a new PHP interface.
addInterface()  : $this
Adds an interface.
addRequiredFile()  : $this
Adds a new required file.
addUseStatement()  : $this
Adds a use statement with an optional alias.
clearConstants()  : $this
Clears all constants.
clearMethods()  : $this
Clears all methods.
clearUseStatements()  : $this
Clears all use statements.
create()  : static
Creates a new struct.
declareUse()  : string
Declares a "use $fullClassName" with " as $alias" if $alias is available, and returns its alias (or not qualified classname) to be used in your actual php code.
declareUses()  : $this
Declares multiple use statements at once.
generateDocblock()  : $this
Generates a docblock from provided information.
getConstant()  : PhpConstant
Returns a constant.
getConstantNames()  : Set
Returns all constant names.
getConstants()  : Map
Returns all constants.
getDescription()  : string
Returns this description.
getDocblock()  : Docblock
Returns the docblock.
getInterfaces()  : Set
Returns the interfaces.
getLongDescription()  : string
Returns the long description.
getMethod()  : PhpMethod
Returns a method.
getMethodByName()  : PhpMethod
Returns amethod.
getMethodNames()  : Set
Returns all method names.
getMethods()  : Map
Returns all methods.
getNamespace()  : string
Returns the namespace.
getQualifiedName()  : string
Returns the qualified name.
getRequiredFiles()  : Set
Returns required files.
getUseAlias()  : string
Returns the usable alias for a qualified name.
getUseStatements()  : Map
Returns all use statements.
hasConstant()  : bool
Checks whether a constant exists.
hasConstantByName()  : bool
Checks whether a constant exists.
hasInterface()  : bool
Checks whether an interface exists.
hasInterfaceByName()  : bool
Checks whether an interface exists.
hasInterfaces()  : bool
Checks whether interfaces exists.
hasMethod()  : bool
Checks whether a method exists or not.
hasMethodByName()  : bool
Checks whether a method exists or not.
hasUseStatement()  : bool
Returns whether the given use statement is present.
removeConstant()  : $this
Removes a constant.
removeConstantByName()  : $this
Removes a constant.
removeInterface()  : $this
Removes an interface.
removeInterfaceByName()  : $this
Removes an interface.
removeMethod()  : $this
Removes a method.
removeMethodByName()  : $this
Removes a method.
removeUseStatement()  : $this
Removes a use statement.
setConstant()  : $this
Add a PhpConstant object.
setConstantByName()  : $this
Create a PhpConstant instance and adds it to the constants Map.
setConstants()  : $this
Sets a collection of constants.
setDescription()  : $this
Sets the description, which will also be used when generating a docblock.
setDocblock()  : $this
Sets the docblock.
setInterfaces()  : $this
Sets a collection of interfaces.
setLongDescription()  : $this
Sets the long description.
setMethod()  : $this
Adds a method.
setMethods()  : $this
Sets a collection of methods.
setMultilineDescription()  : $this
Sets a multi-line description, which will also be used when generating a docblock.
setNamespace()  : $this
Sets the namespace.
setQualifiedName()  : $this
In contrast to setName(), this method accepts the fully qualified name including the namespace.
setRequiredFiles()  : $this
Sets requried files.
setUseStatements()  : $this
Sets use statements.
initConstants()  : void
initInterfaces()  : void

Properties

Methods

__construct()

Create a new PHP interface.

public final __construct([string $name = '' ]) : mixed
Parameters
$name : string = ''

qualified name

Return values
mixed

addInterface()

Adds an interface.

public addInterface(PhpInterface|string $interface) : $this

If the interface is passed as PhpInterface object, the interface is also added as use statement.

Parameters
$interface : PhpInterface|string

interface or qualified name

Return values
$this

addRequiredFile()

Adds a new required file.

public addRequiredFile(string $file) : $this
Parameters
$file : string
Return values
$this

addUseStatement()

Adds a use statement with an optional alias.

public addUseStatement(string $qualifiedName[, string|null $alias = null ]) : $this
Parameters
$qualifiedName : string
$alias : string|null = null
Return values
$this

clearConstants()

Clears all constants.

public clearConstants() : $this
Return values
$this

clearMethods()

Clears all methods.

public clearMethods() : $this
Return values
$this

clearUseStatements()

Clears all use statements.

public clearUseStatements() : $this
Return values
$this

create()

Creates a new struct.

public static create([string $name = '' ]) : static
Parameters
$name : string = ''

the fqcn

Return values
static

declareUse()

Declares a "use $fullClassName" with " as $alias" if $alias is available, and returns its alias (or not qualified classname) to be used in your actual php code.

public declareUse(string $qualifiedName[, string|null $alias = null ]) : string

If the class has already been declared you get only the set alias.

Parameters
$qualifiedName : string
$alias : string|null = null
Return values
string

the used alias

declareUses()

Declares multiple use statements at once.

public declareUses() : $this
Return values
$this

generateDocblock()

Generates a docblock from provided information.

public generateDocblock() : $this
Return values
$this

getConstant()

Returns a constant.

public getConstant(string $name) : PhpConstant
Parameters
$name : string

constant name

Tags
throws
InvalidArgumentException

If the constant cannot be found

Return values
PhpConstant

getConstantNames()

Returns all constant names.

public getConstantNames() : Set
Return values
Set

getConstants()

Returns all constants.

public getConstants() : Map
Return values
Map

getDescription()

Returns this description.

public getDescription() : string
Return values
string

getDocblock()

Returns the docblock.

public getDocblock() : Docblock
Return values
Docblock

getInterfaces()

Returns the interfaces.

public getInterfaces() : Set
Return values
Set

getLongDescription()

Returns the long description.

public getLongDescription() : string
Return values
string

getMethodByName()

Returns amethod.

public getMethodByName(string $name) : PhpMethod
Parameters
$name : string
Tags
throws
InvalidArgumentException

If the method does not exists

Return values
PhpMethod

getMethodNames()

Returns all method names.

public getMethodNames() : Set
Return values
Set

getMethods()

Returns all methods.

public getMethods() : Map
Return values
Map

collection of methods

getNamespace()

Returns the namespace.

public getNamespace() : string
Return values
string

getQualifiedName()

Returns the qualified name.

public getQualifiedName() : string
Return values
string

getRequiredFiles()

Returns required files.

public getRequiredFiles() : Set
Return values
Set

collection of filenames

getUseAlias()

Returns the usable alias for a qualified name.

public getUseAlias(string $qualifiedName) : string
Parameters
$qualifiedName : string
Return values
string

the alias

getUseStatements()

Returns all use statements.

public getUseStatements() : Map
Return values
Map

collection of use statements

hasConstantByName()

Checks whether a constant exists.

public hasConstantByName(string $name) : bool
Parameters
$name : string

constant name

Return values
bool

hasInterfaceByName()

Checks whether an interface exists.

public hasInterfaceByName(string $name) : bool
Parameters
$name : string

interface name

Return values
bool

hasInterfaces()

Checks whether interfaces exists.

public hasInterfaces() : bool
Return values
bool

true if interfaces are available and false if not

hasMethod()

Checks whether a method exists or not.

public hasMethod(PhpMethod $method) : bool
Parameters
$method : PhpMethod
Return values
bool

true if it exists and false if not

hasMethodByName()

Checks whether a method exists or not.

public hasMethodByName(string $name) : bool
Parameters
$name : string
Return values
bool

hasUseStatement()

Returns whether the given use statement is present.

public hasUseStatement(string $qualifiedName) : bool
Parameters
$qualifiedName : string
Return values
bool

removeConstant()

Removes a constant.

public removeConstant(PhpConstant $constant) : $this
Parameters
$constant : PhpConstant
Tags
throws
InvalidArgumentException

If the constant cannot be found

Return values
$this

removeConstantByName()

Removes a constant.

public removeConstantByName(string $name) : $this
Parameters
$name : string

constant name

Tags
throws
InvalidArgumentException

If the constant cannot be found

Return values
$this

removeInterface()

Removes an interface.

public removeInterface(PhpInterface $interface) : $this

If the interface is passed as PhpInterface object, the interface is also remove from the use statements.

Parameters
$interface : PhpInterface

interface or qualified name

Return values
$this

removeInterfaceByName()

Removes an interface.

public removeInterfaceByName(string $name) : $this

If the interface is passed as PhpInterface object, the interface is also remove from the use statements.

Parameters
$name : string

interface qualified name

Return values
$this

removeMethodByName()

Removes a method.

public removeMethodByName(string $name) : $this
Parameters
$name : string

method name or Method instance

Tags
throws
InvalidArgumentException

If the method does not exist

Return values
$this

removeUseStatement()

Removes a use statement.

public removeUseStatement(string $qualifiedName) : $this
Parameters
$qualifiedName : string
Return values
$this

setConstantByName()

Create a PhpConstant instance and adds it to the constants Map.

public setConstantByName(string $name[, mixed $value = null ][, bool $isExpression = false ]) : $this
Parameters
$name : string

constant name

$value : mixed = null
$isExpression : bool = false
Return values
$this

setConstants()

Sets a collection of constants.

public setConstants(array<string|int, mixed>|array<string|int, PhpConstant$constants) : $this
Parameters
$constants : array<string|int, mixed>|array<string|int, PhpConstant>
Return values
$this

setDescription()

Sets the description, which will also be used when generating a docblock.

public setDescription(string $description) : $this
Parameters
$description : string
Return values
$this

setDocblock()

Sets the docblock.

public setDocblock(Docblock|string $doc) : $this
Parameters
$doc : Docblock|string
Return values
$this

setInterfaces()

Sets a collection of interfaces.

public setInterfaces(array<string|int, PhpInterface$interfaces) : $this
Parameters
$interfaces : array<string|int, PhpInterface>
Return values
$this

setLongDescription()

Sets the long description.

public setLongDescription(string $longDescription) : $this
Parameters
$longDescription : string
Return values
$this

setMethods()

Sets a collection of methods.

public setMethods(array<string|int, PhpMethod$methods) : $this
Parameters
$methods : array<string|int, PhpMethod>
Return values
$this

setMultilineDescription()

Sets a multi-line description, which will also be used when generating a docblock.

public setMultilineDescription(array<string|int, mixed> $description) : $this

Each line is a value of the $description array.

Parameters
$description : array<string|int, mixed>
Return values
$this

setNamespace()

Sets the namespace.

public setNamespace(string $namespace) : $this
Parameters
$namespace : string
Return values
$this

setQualifiedName()

In contrast to setName(), this method accepts the fully qualified name including the namespace.

public setQualifiedName(string $name) : $this
Parameters
$name : string
Return values
$this

setRequiredFiles()

Sets requried files.

public setRequiredFiles(array<string|int, mixed> $files) : $this
Parameters
$files : array<string|int, mixed>
Return values
$this

setUseStatements()

Sets use statements.

public setUseStatements(array<string|int, mixed> $useStatements) : $this
Parameters
$useStatements : array<string|int, mixed>
Tags
see

#addUseStatement

see

#declareUses()

Return values
$this

initConstants()

private initConstants() : void
Return values
void

initInterfaces()

private initInterfaces() : void
Return values
void

Search results