PostgresGrammar
class PostgresGrammar extends Grammar
Traits
Properties
| static protected array | $macros | The registered string macros. |
from Macroable |
| protected Connection | $connection | The connection used for escaping values. |
from Grammar |
| protected string[] | $modifiers | The possible column modifiers. |
|
| protected bool | $transactions | If this Grammar supports schema changes wrapped in a transaction. |
|
| protected string[] | $fluentCommands | The commands to be executed outside of create or alter command. |
|
| protected string[] | $serials | The columns available as serials. |
Methods
Mix another object into the class.
Dynamically handle calls to the class.
Dynamically handle calls to the class.
Wrap a table in keyword identifiers.
Wrap a table that has an alias.
Convert an array of column names into a delimited string.
Get the appropriate query parameter place-holder for a value.
Escapes a value for safe SQL embedding.
Split the given JSON selector into the field and the optional path and wrap them separately.
Wrap the given JSON path.
Wrap the given JSON path segment.
Compile a create database command.
Compile a drop database if exists command.
Compile the query to determine the schemas.
Compile the query to determine if the given table exists.
Compile the query to determine the tables.
Compile the query to determine the views.
Compile the query to determine the user-defined types.
Compile the query to determine the columns.
Compile the query to determine the indexes.
Compile the query to determine the foreign keys.
Compile the command to enable foreign key constraints.
Compile the command to disable foreign key constraints.
Compile a change column command into a series of SQL statements.
Add the column modifiers to the definition.
Get the command with a given name if it exists on the blueprint.
Determine if a command with a given name exists on the blueprint.
Format a value so that it can be used in "default" clauses.
Check if this Grammar supports schema changes wrapped in a transaction.
Compile the query to compare the schema.
Compile the auto-incrementing column starting values.
Compile a spatial index with operator class key command.
Convert an array of column names to a delimited string with operator class.
Compile a drop table (if exists) command.
Compile the SQL needed to drop all tables.
Compile the SQL needed to drop all views.
Compile the SQL needed to drop all types.
Compile the SQL needed to drop all domains.
Compile a drop spatial index command.
Quote-escape the given tables, views, or types.
Get the SQL for an auto-increment column modifier.
Get the SQL for a generated virtual column modifier.
Get the SQL for a generated stored column modifier.
Get the SQL for an identity column modifier.
Details
in
Macroable at line 28
static void
macro(string $name, callable|object $macro)
Register a custom macro.
Boot-only. Macros persist in a static property for the worker lifetime and apply to every subsequent call on the macroable class.
in
Macroable at line 41
static void
mixin(object $mixin, bool $replace = true)
Mix another object into the class.
Boot-only. Delegates to macro() for each method; registered macros persist in a static property for the worker lifetime.
in
Macroable at line 57
static bool
hasMacro(string $name)
Check if macro is registered.
in
Macroable at line 68
static void
flushMacros()
Flush the existing macros.
Boot or tests only. Clears worker-wide macros; concurrent coroutines may resolve different methods depending on timing.
in
Macroable at line 78
static mixed
__callStatic(string $method, array $parameters)
Dynamically handle calls to the class.
in
Macroable at line 103
mixed
__call(string $method, array $parameters)
Dynamically handle calls to the class.
in
Grammar at line 24
__construct(Connection $connection)
Create a new grammar instance.
in
Grammar at line 35
array
wrapArray(array $values)
Wrap an array of values.
in
Grammar at line 384
string
wrapTable(Expression|string $table, string|null $prefix = null)
Wrap a table in keyword identifiers.
in
Grammar at line 395
string|int|float
wrap(Expression|string $value)
Wrap a value in keyword identifiers.
in
Grammar at line 101
protected string
wrapAliasedValue(string $value)
Wrap a value that has an alias.
in
Grammar at line 111
protected string
wrapAliasedTable(string $value, string|null $prefix = null)
Wrap a table that has an alias.
in
Grammar at line 125
protected string
wrapSegments(array $segments)
Wrap the given value segments.
in
Grammar at line 137
protected string
wrapValue(string $value)
Wrap a single string in keyword identifiers.
in
Grammar at line 151
protected string
wrapJsonSelector(string $value)
Wrap the given JSON selector.
in
Grammar at line 159
protected bool
isJsonSelector(string $value)
Determine if the given string is a JSON selector.
in
Grammar at line 169
string
columnize(array $columns)
Convert an array of column names into a delimited string.
in
Grammar at line 177
string
parameterize(array $values)
Create query parameter place-holders for an array.
in
Grammar at line 185
string|int|float
parameter(mixed $value)
Get the appropriate query parameter place-holder for a value.
in
Grammar at line 195
string
quoteString(string|array $value)
Quote the given string literal.
in
Grammar at line 207
string
escape(string|float|int|bool|null $value, bool $binary = false)
Escapes a value for safe SQL embedding.
in
Grammar at line 215
bool
isExpression(mixed $value)
Determine if the given value is a raw expression.
in
Grammar at line 223
string|int|float
getValue(Expression|string|int|float $expression)
Transforms expressions to their scalar types.
in
Grammar at line 235
string
getDateFormat()
Get the format for database stored dates.
in
Grammar at line 246
static void
flushState()
Flush all static state.
in
CompilesJsonPaths at line 15
protected array
wrapJsonFieldAndPath(string $column)
Split the given JSON selector into the field and the optional path and wrap them separately.
in
CompilesJsonPaths at line 29
protected string
wrapJsonPath(string $value, string $delimiter = '->')
Wrap the given JSON path.
in
CompilesJsonPaths at line 43
protected string
wrapJsonPathSegment(string $segment)
Wrap the given JSON path segment.
at line 45
string
compileCreateDatabase(string $name)
Compile a create database command.
in
Grammar at line 54
string
compileDropDatabaseIfExists(string $name)
Compile a drop database if exists command.
at line 59
string
compileSchemas()
Compile the query to determine the schemas.
at line 69
string|null
compileTableExists(string|null $schema, string $table)
Compile the query to determine if the given table exists.
at line 84
string
compileTables(string|array|null $schema)
Compile the query to determine the tables.
at line 96
string
compileViews(string|array|null $schema)
Compile the query to determine the views.
at line 106
string
compileTypes(string|array|null $schema)
Compile the query to determine the user-defined types.
at line 134
string
compileColumns(string|null $schema, string $table)
Compile the query to determine the columns.
at line 158
string
compileIndexes(string|null $schema, string $table)
Compile the query to determine the indexes.
at line 386
string
compileVectorIndex(Blueprint $blueprint, Fluent $command)
Compile a vector index key command.
at line 180
string
compileForeignKeys(string|null $schema, string $table)
Compile the query to determine the foreign keys.
at line 578
string
compileEnableForeignKeyConstraints()
Compile the command to enable foreign key constraints.
at line 587
string
compileDisableForeignKeyConstraints()
Compile the command to disable foreign key constraints.
in
Grammar at line 161
array|string
compileRenameColumn(Blueprint $blueprint, Fluent $command)
Compile a rename column command.
at line 246
array|string
compileChange(Blueprint $blueprint, Fluent $command)
Compile a change column command into a series of SQL statements.
at line 352
string
compileFulltext(Blueprint $blueprint, Fluent $command)
Compile a fulltext index key command.
at line 530
string
compileDropFullText(Blueprint $blueprint, Fluent $command)
Compile a drop fulltext index command.
at line 421
string|null
compileForeign(Blueprint $blueprint, Fluent $command)
Compile a foreign key command.
at line 546
array|string|null
compileDropForeign(Blueprint $blueprint, Fluent $command)
Compile a drop foreign key command.
in
Grammar at line 248
protected array
getColumns(Blueprint $blueprint)
Compile the blueprint's added column definitions.
in
Grammar at line 264
protected string
getColumn(Blueprint $blueprint, Fluent $column)
Compile the column definition.
in
Grammar at line 277
protected string
getType(Fluent $column)
Get the SQL for the column data type.
in
Grammar at line 285
protected void
typeComputed(Fluent $column)
Create the column definition for a generated, computed column type.
at line 948
protected string
typeVector(Fluent $column)
Create the column definition for a vector type.
at line 958
protected string
typeTsvector(Fluent $column)
Create the column definition for a tsvector type.
in
Grammar at line 309
protected string
typeRaw(Fluent $column)
Create the column definition for a raw column type.
in
Grammar at line 317
protected string
addModifiers(string $sql, Blueprint $blueprint, Fluent $column)
Add the column modifiers to the definition.
in
Grammar at line 331
protected Fluent|null
getCommandByName(Blueprint $blueprint, string $name)
Get the command with a given name if it exists on the blueprint.
in
Grammar at line 347
protected array
getCommandsByName(Blueprint $blueprint, string $name)
Get all of the commands with a given name.
in
Grammar at line 357
protected bool
hasCommand(Blueprint $blueprint, string $name)
Determine if a command with a given name exists on the blueprint.
in
Grammar at line 374
array
prefixArray(string $prefix, array $values)
Add a prefix to an array of values.
in
Grammar at line 405
protected string|int|float
getDefaultValue(mixed $value)
Format a value so that it can be used in "default" clauses.
in
Grammar at line 425
array
getFluentCommands()
Get the fluent commands for the grammar.
in
Grammar at line 433
bool
supportsSchemaTransactions()
Check if this Grammar supports schema changes wrapped in a transaction.
at line 122
protected string
compileSchemaWhereClause(string|array|null $schema, string $column)
Compile the query to compare the schema.
at line 206
string
compileCreate(Blueprint $blueprint, Fluent $command)
Compile a create table command.
at line 219
string
compileAdd(Blueprint $blueprint, Fluent $command)
Compile a column addition command.
at line 231
string|null
compileAutoIncrementStartingValues(Blueprint $blueprint, Fluent $command)
Compile the auto-incrementing column starting values.
at line 277
string
compilePrimary(Blueprint $blueprint, Fluent $command)
Compile a primary key command.
at line 289
array
compileUnique(Blueprint $blueprint, Fluent $command)
Compile a unique key command.
at line 337
string
compileIndex(Blueprint $blueprint, Fluent $command)
Compile a plain index key command.
at line 372
string
compileSpatialIndex(Blueprint $blueprint, Fluent $command)
Compile a spatial index key command.
at line 394
protected string
compileIndexWithOperatorClass(Blueprint $blueprint, Fluent $command)
Compile a spatial index with operator class key command.
at line 411
protected string
columnizeWithOperatorClass(array $columns, string $operatorClass)
Convert an array of column names to a delimited string with operator class.
at line 451
string
compileDropIfExists(Blueprint $blueprint, Fluent $command)
Compile a drop table (if exists) command.
at line 459
string
compileDropAllTables(array $tables)
Compile the SQL needed to drop all tables.
at line 467
string
compileDropAllViews(array $views)
Compile the SQL needed to drop all views.
at line 475
string
compileDropAllTypes(array $types)
Compile the SQL needed to drop all types.
at line 483
string
compileDropAllDomains(array $domains)
Compile the SQL needed to drop all domains.
at line 491
string
compileDropColumn(Blueprint $blueprint, Fluent $command)
Compile a drop column command.
at line 501
string
compileDropPrimary(Blueprint $blueprint, Fluent $command)
Compile a drop primary key command.
at line 512
string
compileDropUnique(Blueprint $blueprint, Fluent $command)
Compile a drop unique key command.
at line 522
string
compileDropIndex(Blueprint $blueprint, Fluent $command)
Compile a drop index command.
at line 538
string
compileDropSpatialIndex(Blueprint $blueprint, Fluent $command)
Compile a drop spatial index command.
at line 556
string
compileRename(Blueprint $blueprint, Fluent $command)
Compile a rename table command.
at line 566
string
compileRenameIndex(Blueprint $blueprint, Fluent $command)
Compile a rename index command.
at line 596
string|null
compileComment(Blueprint $blueprint, Fluent $command)
Compile a comment command.
at line 613
string
compileTableComment(Blueprint $blueprint, Fluent $command)
Compile a table comment command.
at line 625
array
escapeNames(array $names)
Quote-escape the given tables, views, or types.
at line 636
protected string
typeChar(Fluent $column)
Create the column definition for a char type.
at line 648
protected string
typeString(Fluent $column)
Create the column definition for a string type.
at line 660
protected string
typeTinyText(Fluent $column)
Create the column definition for a tiny text type.
at line 668
protected string
typeText(Fluent $column)
Create the column definition for a text type.
at line 676
protected string
typeMediumText(Fluent $column)
Create the column definition for a medium text type.
at line 684
protected string
typeLongText(Fluent $column)
Create the column definition for a long text type.
at line 692
protected string
typeInteger(Fluent $column)
Create the column definition for an integer type.
at line 700
protected string
typeBigInteger(Fluent $column)
Create the column definition for a big integer type.
at line 708
protected string
typeMediumInteger(Fluent $column)
Create the column definition for a medium integer type.
at line 716
protected string
typeTinyInteger(Fluent $column)
Create the column definition for a tiny integer type.
at line 724
protected string
typeSmallInteger(Fluent $column)
Create the column definition for a small integer type.
at line 732
protected string
typeFloat(Fluent $column)
Create the column definition for a float type.
at line 744
protected string
typeDouble(Fluent $column)
Create the column definition for a double type.
at line 752
protected string
typeReal(Fluent $column)
Create the column definition for a real type.
at line 760
protected string
typeDecimal(Fluent $column)
Create the column definition for a decimal type.
at line 768
protected string
typeBoolean(Fluent $column)
Create the column definition for a boolean type.
at line 776
protected string
typeEnum(Fluent $column)
Create the column definition for an enumeration type.
at line 788
protected string
typeJson(Fluent $column)
Create the column definition for a json type.
at line 796
protected string
typeJsonb(Fluent $column)
Create the column definition for a jsonb type.
at line 804
protected string
typeDate(Fluent $column)
Create the column definition for a date type.
at line 816
protected string
typeDateTime(Fluent $column)
Create the column definition for a date-time type.
at line 824
protected string
typeDateTimeTz(Fluent $column)
Create the column definition for a date-time (with time zone) type.
at line 832
protected string
typeTime(Fluent $column)
Create the column definition for a time type.
at line 840
protected string
typeTimeTz(Fluent $column)
Create the column definition for a time (with time zone) type.
at line 848
protected string
typeTimestamp(Fluent $column)
Create the column definition for a timestamp type.
at line 860
protected string
typeTimestampTz(Fluent $column)
Create the column definition for a timestamp (with time zone) type.
at line 872
protected string
typeYear(Fluent $column)
Create the column definition for a year type.
at line 884
protected string
typeBinary(Fluent $column)
Create the column definition for a binary type.
at line 892
protected string
typeUuid(Fluent $column)
Create the column definition for a uuid type.
at line 900
protected string
typeIpAddress(Fluent $column)
Create the column definition for an IP address type.
at line 908
protected string
typeMacAddress(Fluent $column)
Create the column definition for a MAC address type.
at line 916
protected string
typeGeometry(Fluent $column)
Create the column definition for a spatial Geometry type.
at line 932
protected string
typeGeography(Fluent $column)
Create the column definition for a spatial Geography type.
at line 966
protected string|null
modifyCollate(Blueprint $blueprint, Fluent $column)
Get the SQL for a collation column modifier.
at line 978
protected string
modifyNullable(Blueprint $blueprint, Fluent $column)
Get the SQL for a nullable column modifier.
at line 990
protected string|null
modifyDefault(Blueprint $blueprint, Fluent $column)
Get the SQL for a default column modifier.
at line 1010
protected string|null
modifyIncrement(Blueprint $blueprint, Fluent $column)
Get the SQL for an auto-increment column modifier.
at line 1025
protected string|null
modifyVirtualAs(Blueprint $blueprint, Fluent $column)
Get the SQL for a generated virtual column modifier.