DB
object
%DB
/phlo/resources/DB/DB.phlo
prop
%DB -> PDO
line 11
Deze functie genereert een fout als er geen PDO-connector is gedefinieerd voor databasebewerkingen.
error('No PDO connector defined')prop
%DB -> fieldQuotes
line 12
Haal de veldcitaten op voor een specifiek databaseveld, zodat de SQL-query's correct worden opgemaakt.
btprop
%DB -> savepoint
line 13
Maakt een savepoint in de huidige database-transactie, waardoor gedeeltelijke terugdraaien mogelijk is.
prop
%DB -> insertIgnore
line 14
Voegt een nieuw record toe aan de database en negeert eventuele dubbele invoeren die een conflict zouden veroorzaken.
' IGNORE'prop
%DB -> insertOnConflict
line 15
Voegt een nieuw record toe aan de database en werkt het bestaande record bij in geval van een conflict.
voidmethod
%DB -> load (string $table, string $columns = '*', string $where = void, string $joins = void, string $group = void, string $limit = void, string $order = void, ...$args)
line 17
Laadt gegevens uit de opgegeven tabel in de database, met de mogelijkheid om optioneel kolommen te selecteren, te filteren met voorwaarden, te koppelen aan andere tabellen, te groeperen, te sorteren en de resultaten te beperken.
$table = strpos($table, space) || strpos($table, dot) ? $table : "$this->fieldQuotes$table$this->fieldQuotes"
$args && $where = ($where ? "$where AND " : void).loop(array_keys($args), fn($column) => $table.dot.$this->quoteId($column).'=?', ' AND ')
$joins && $joins = " $joins"
$where && $where = " WHERE $where"
$group && $group = " GROUP BY $group"
$order && $order = " ORDER BY $order"
$limit && $limit = " LIMIT $limit"
$query = "SELECT $columns FROM $table$joins$where$group$order$limit"
return $this->query($query, ...array_values($args))method
%DB -> query ($query, ...$args)
line 29
Voert een databasequery uit met de opgegeven SQL-instructie en argumenten, en retourneert de resultaten.
$this->queryRun($query, $args, true)method
%DB -> queryRun ($query, $args, $retry)
line 35
Voert een databasequery uit met optionele argumenten en probeert opnieuw bij specifieke fouten voor idempotente leesverklaringen.
try {
if (!$args) $stmt = $this->PDO->query($query)
else {
$stmt = $this->PDO->prepare($query)
$stmt->execute($args)
}
if (debug){
$match = regex('/\b(UPDATE|INSERT INTO|DELETE FROM|FROM)\b\s+([`"\[]?\w+[`"\]]?)/i', strtr($query, [$this->fieldQuotes => void]))
$where = strtr(regex('/\bWHERE (\b.+)/is', $query)[1] ?? void, [' ORDER BY' => void])
$match && debug("Q: $match[1] $match[2]".strtr(rtrim(" $where "), [dq => void])." (".$stmt->rowCount().")")
}
return $stmt
}
catch (\PDOException $e){
// Retry only idempotent read statements outside a transaction. WITH is excluded: a `WITH ... UPDATE`
// or `WITH ... DELETE` CTE is a mutation that may already have run before the connection dropped
// (error 2013), and a reconnect would start a fresh, transaction-less session.
if (!$retry || !$this->goneAway($e) || $this->PDO->inTransaction() || !preg_match('/^\s*\(*\s*(SELECT|SHOW|EXPLAIN|DESCRIBE|DESC)\b/i', $query)) error('Database error'.colon.lf.$query.lf.lf.$e->getMessage())
unset($this->PDO)
return $this->queryRun($query, $args, false)
}method
%DB -> goneAway ($e)
line 59
Controleert of een databaseverbindingfout aangeeft dat de verbinding is verloren of de server niet beschikbaar is.
in_array((int)($e->errorInfo[1] ?? 0), [2006, 2013], true) || stripos($e->getMessage(), 'gone away') !== false || stripos($e->getMessage(), 'lost connection') !== falsemethod
%DB -> column (...$args)
line 61
Haalt een enkele kolom op uit de resultaten van een databasequery, met behulp van de opgegeven argumenten om de gegevens te laden.
$this->load(...$args)->fetchAll(\PDO::FETCH_COLUMN)method
%DB -> item (...$args)
line 62
Laadt een item uit de database met de opgegeven argumenten en retourneert het als een enkele kolomwaarde, of null als het niet is gevonden.
($v = $this->load(...$args)->fetch(\PDO::FETCH_COLUMN)) === false ? null : $vmethod
%DB -> pair (...$args)
line 63
Haalt alle rijen uit de database op als een sleutel-waarde paar array met de opgegeven argumenten.
$this->load(...$args)->fetchAll(\PDO::FETCH_KEY_PAIR)method
%DB -> group (...$args)
line 64
Haal alle records uit de database op, gegroepeerd op een opgegeven kolom of kolommen, en retourneer de resultaten als een array van objecten van de opgegeven klasse.
$this->load(...$args)->fetchAll(\PDO::FETCH_GROUP|\PDO::FETCH_CLASS, obj::class)method
%DB -> records (...$args)
line 65
Haalt alle records uit de database op als objecten van de opgegeven klasse, met behulp van de meegeleverde argumenten voor de query.
$this->load(...$args)->fetchAll(\PDO::FETCH_CLASS|\PDO::FETCH_UNIQUE, obj::class)method
%DB -> rows (...$args)
line 66
Haalt alle rijen uit de database op als instanties van de opgegeven klasse met behulp van de meegeleverde argumenten.
$this->load(...$args)->fetchAll(\PDO::FETCH_CLASS, obj::class)method
%DB -> record (...$args)
line 67
Haal een enkel record uit de database op als een object van de opgegeven klasse, en retourneer null als er geen record wordt gevonden.
$this->load(...$args)->fetchObject(obj::class) ?: nullmethod
%DB -> quoteList (array $ids)
line 68
Quote elk element in de opgegeven array van ID's voor veilig gebruik in SQL-query's, en retourneert een door komma's gescheiden string.
loop($ids, fn($id) => $this->PDO->quote((string)$id), comma)method
%DB -> quoteId ($id)
line 72
Escaped een identifier voor gebruik in een SQL-query, zodat deze correct wordt geciteerd om SQL-injectie te voorkomen.
$this->fieldQuotes.str_replace($this->fieldQuotes, $this->fieldQuotes.$this->fieldQuotes, (string)$id).$this->fieldQuotesmethod
%DB -> create (string $table, ...$data)
line 74
Voegt een nieuw record toe aan de opgegeven tabel met de verstrekte gegevens, waarbij conflicten optioneel worden genegeerd op basis van de 'ignore'-vlag.
if ($ignore = $data['ignore'] ?? false) unset($data['ignore'])
$columns = implode(comma, loop(array_keys($data), fn($k) => $this->quoteId($k)))
$values = implode(comma, array_fill(0, count($data), qm))
$query = "INSERT".($ignore ? $this->insertIgnore : void)." INTO $table ($columns) VALUES ($values)".($ignore ? $this->insertOnConflict : void)
$this->query($query, ...array_values(loop($data, fn($value) => is_a($value, obj::class) ? $value->id : $value)))
return $this->lastId() ?: ($data['id'] ?? null)method
%DB -> lastId
line 83
Geeft de ID van de laatst ingevoegde rij in de database terug.
$this->PDO->lastInsertId()method
%DB -> change (string $table, string $where, ...$data)
line 85
Werk records bij in de opgegeven tabel op basis van de gegeven voorwaarden en gegevens.
$whereCount = substr_count($where, qm)
$updates = isset($data['updates']) ? $data['updates'] : void
unset($data['updates'])
$updates .= (($wheres = array_slice(array_keys($data), $whereCount)) && $updates ? comma : void).loop($wheres, fn($key) => $this->quoteId($key).'=?', comma)
$query = "UPDATE $table SET $updates WHERE $where"
$args = array_values([...array_slice($data, $whereCount), ...array_slice($data, 0, $whereCount)])
return $this->query($query, ...$args)->rowCount()method
%DB -> delete (string $table, string $where, ...$args)
line 95
Verwijdert rijen uit de opgegeven tabel op basis van de gegeven voorwaarde. Het retourneert het aantal aangetaste rijen.
$this->query("DELETE FROM $table WHERE $where", ...$args)->rowCount()method
%DB -> begin
line 96
Start een nieuwe database transactie met PDO.
$this->PDO->beginTransaction()method
%DB -> commit
line 97
Bevestigt de huidige transactie in de database, waardoor alle wijzigingen die tijdens de transactie zijn aangebracht permanent worden.
$this->PDO->commit()method
%DB -> rollback
line 98
Rol de huidige transactie terug als deze actief is, waardoor alle wijzigingen die tijdens de transactie zijn aangebracht, ongedaan worden gemaakt.
$this->PDO->inTransaction() && $this->PDO->rollBack()method
%DB -> transaction ($callback)
line 100
Voert een database-transactie uit, waarbij een callbackfunctie binnen de transactiecontext kan worden uitgevoerd. Als er een fout optreedt, wordt er teruggekeerd naar het laatste savepoint of het begin van de transactie, wat de gegevensintegriteit waarborgt.
if (!$this->PDO->inTransaction()){
$this->begin
try {
$result = $callback()
$this->commit
return $result
} catch (\Throwable $e){
$this->rollback
throw $e
}
}
// Nested: a savepoint gives the inner unit its own rollback point, so its failure
// (e.g. an audit insert) is undone even when the outer transaction commits.
$sp = 'phlo_sp_'.(++$this->savepoint)
$this->PDO->exec('SAVEPOINT '.$sp)
try {
$result = $callback()
$this->PDO->exec('RELEASE SAVEPOINT '.$sp)
$this->savepoint--
return $result
} catch (\Throwable $e){
$this->PDO->exec('ROLLBACK TO SAVEPOINT '.$sp)
$this->PDO->exec('RELEASE SAVEPOINT '.$sp)
$this->savepoint--
throw $e
}object
%JSONDB
/phlo/resources/DB/JSONDB.phlo
static
JSONDB :: __handle
line 11
JSONDB::$__handle is een verwijzing naar de interne bestandsverwijzing die wordt gebruikt voor het openen van de JSON-database die is opgegeven door het $file-pad.
"JSONDB/$file"method
%JSONDB -> __construct (private string $file)
line 12
De constructor initialiseert een JSONDB-instantie en zorgt ervoor dat de map voor het opgegeven bestand bestaat, en maakt deze indien nodig aan.
$dir = dirname($this->file)
is_dir($dir) || mkdir($dir, 0755, true) || error("JSONDB: cannot create dir $dir")prop
%JSONDB -> PDO
line 16
Deze functie genereert een foutmelding die aangeeft dat de JSONDB-driver niet compatibel is met PDO.
error('JSONDB driver does not use PDO')prop
%JSONDB -> fieldQuotes
line 17
Haal de citaten op voor een specifiek veld in een JSONDB-resource.
voidprop
%JSONDB -> lastInsertedId
line 18
Geeft de ID van het laatst ingevoegde record in de JSONDB.
nullmethod
%JSONDB -> quoteList (array $ids)
line 25
Voegt een array van ID's samen tot een enkele string, gescheiden door komma's, en omhult deze in dubbele aanhalingstekens.
dq.implode(dq.comma.dq, $ids).dqmethod
%JSONDB -> objRead
line 27
Leest een JSON-bestand en retourneert de inhoud als een associatieve array. Als het bestand niet bestaat of leeg is, retourneert het een lege array.
file_exists($this->file) ? json_decode(file_get_contents($this->file), true) ?: [] : []method
%JSONDB -> objWrite (array $data)
line 28
Schrijft de opgegeven arraygegevens naar een JSON-bestand, waarbij het in een mooi opgemaakt formaat wordt gecodeerd en ervoor wordt gezorgd dat Unicode-tekens niet worden ontsnapt.
file_put_contents($this->file, json_encode(array_values($data), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE), LOCK_EX)method
%JSONDB -> objNextId (array $data)
line 29
Geeft de volgende beschikbare ID voor een nieuw object in de gegeven array van gegevens door de maximale huidige ID te vinden en er één bij op te tellen, of retourneert 1 als de array leeg is.
$data ? (int)max(array_column($data, 'id')) + 1 : 1method
%JSONDB -> objFilter (array $data, string $where = void, ...$args)
line 31
Filtert een array van gegevens op basis van opgegeven voorwaarden in de 'where'-clausule en retourneert alleen de overeenkomende rijen.
if (!$where) return $data
$filtered = []
foreach ($data AS $row){
$match = true
$parts = preg_split('/\s+AND\s+/i', $where)
$argIndex = 0
foreach ($parts AS $part){
if (preg_match('/^[`"]?(\w+)[`"]?\s*=\s*\?$/', trim($part), $m)){
$column = $m[1]
$value = $args[$argIndex++] ?? null
if (($row[$column] ?? null) != $value) $match = false
}
elseif (preg_match('/^[`"]?(\w+)[`"]?\s+IN\s*\((.+)\)$/i', trim($part), $m)){
$column = $m[1]
$ids = array_map(fn($v) => trim($v, "\"' "), explode(comma, $m[2]))
if (!in_array($row[$column] ?? null, $ids)) $match = false
}
}
$match && $filtered[] = $row
}
return $filteredmethod
%JSONDB -> objSelect (string $where = void, string $limit = void, string $order = void, ...$args)
line 55
Selecteert objecten uit de JSON-database op basis van opgegeven voorwaarden, met optionele sortering en beperking van de resultaten.
$data = $this->objFilter($this->objRead(), $where, ...array_values($args))
if ($order){
$desc = str_contains($order, 'DESC')
$col = trim(preg_replace('/\s+(ASC|DESC)/i', void, $order), '` ')
usort($data, fn($a, $b) => $desc ? ($b[$col] ?? 0) <=> ($a[$col] ?? 0) : ($a[$col] ?? 0) <=> ($b[$col] ?? 0))
}
$limit && $data = array_slice($data, 0, (int)$limit)
return $datamethod
%JSONDB -> create (string $table, ...$data)
line 66
Voegt een nieuwe invoer toe in de opgegeven tabel van de JSON-database, waarbij een ID wordt toegewezen als deze niet is opgegeven, en optioneel duplicaten op basis van de ID negeert.
if ($ignore = $data['ignore'] ?? false) unset($data['ignore'])
$all = $this->objRead()
$data['id'] ??= $this->objNextId($all)
foreach ($data AS $key => $value) is_a($value, 'obj') && $data[$key] = $value->id
if ($ignore){
foreach ($all AS $row) if (($row['id'] ?? null) == $data['id']) return $data['id']
}
$all[] = $data
$this->objWrite($all)
$this->lastInsertedId = $data['id']
return $data['id']method
%JSONDB -> change (string $table, string $where, ...$data)
line 80
Werk rijen in de opgegeven tabel bij die voldoen aan de gegeven voorwaarde met nieuwe gegevens en retourneer het aantal gewijzigde rijen.
$all = $this->objRead()
$whereCount = substr_count($where, qm)
$whereArgs = array_slice(array_values($data), 0, $whereCount)
$updates = array_slice($data, $whereCount, null, true)
$changed = 0
foreach ($all AS &$row){
if ($this->objFilter([$row], $where, ...$whereArgs)){
foreach ($updates AS $key => $value) $row[$key] = $value
$changed++
}
}
unset($row)
$this->objWrite($all)
return $changedmethod
%JSONDB -> delete (string $table, string $where, ...$args)
line 97
Verwijdert records uit de opgegeven tabel in de JSON-database die voldoen aan de gegeven voorwaarde.
$all = $this->objRead()
$matching = $this->objFilter($all, $where, ...$args)
$matchIds = array_column($matching, 'id')
$remaining = array_values(array_filter($all, fn($row) => !in_array($row['id'] ?? null, $matchIds)))
$this->objWrite($remaining)
return count($matching)method
%JSONDB -> load (string $table, string $columns = '*', string $where = void, string $joins = void, string $group = void, string $limit = void, string $order = void, ...$args)
line 106
Laadt gegevens uit een opgegeven tabel in JSONDB, met de mogelijkheid om optioneel kolommen te selecteren, te filteren met voorwaarden, te koppelen aan andere tabellen, te groeperen, resultaten te beperken en te ordenen.
!$where && $args && $where = loop(array_keys($args), fn($column) => "$column=?", ' AND ')
$data = $this->objSelect($where, $limit, $order, ...array_values($args))
return %JSON_result($data)method
%JSONDB -> query ($query, ...$args)
line 111
Voert een query uit tegen de JSONDB, maar ondersteunt geen ruwe SQL-queries.
error('JSONDB driver does not support raw SQL queries')method
%JSONDB -> begin
line 113
Begint een transactie in de JSONDB, waardoor meerdere bewerkingen atomair kunnen worden uitgevoerd.
nullmethod
%JSONDB -> commit
line 114
Bevestigt de huidige transactie in de JSONDB en slaat alle wijzigingen op die tijdens de transactie zijn aangebracht.
nullmethod
%JSONDB -> rollback
line 115
Herstelt de laatste transactie in de JSONDB en brengt de database terug naar de vorige staat.
nullobject
%JSON_result
/phlo/resources/DB/JSON.result.phlo
static
JSON_result :: __handle
line 9
Deze eigenschap wordt gebruikt om toegang te krijgen tot de interne handle van een JSON_result-object.
nullprop
%JSON_result -> data
line 10
Toegang tot de `$data`-eigenschap van het `JSON_result`-object, dat de geparsed gegevens van een JSON-respons bevat.
[]method
%JSON_result -> __construct (array $data)
line 11
Initialiseert een JSON_result-object met de opgegeven gegevensarray.
$this->data = $datamethod
%JSON_result -> fetchAll ($mode = 2)
line 13
Haal alle resultaten op uit de JSON-resource volgens de opgegeven modus, met verschillende indelingen zoals een enkele kolom, sleutel-waarde paren of objecten.
if ($mode === \PDO::FETCH_COLUMN) return loop($this->data, fn($row) => reset((array)$row))
if ($mode === \PDO::FETCH_KEY_PAIR){
$out = []
foreach ($this->data AS $row){
$vals = array_values((array)$row)
$out[$vals[0] ?? null] = $vals[1] ?? null
}
return $out
}
if (($mode & (\PDO::FETCH_CLASS | \PDO::FETCH_UNIQUE)) === (\PDO::FETCH_CLASS | \PDO::FETCH_UNIQUE)){
$out = []
foreach ($this->data AS $row){
$o = new obj
foreach ((array)$row AS $k => $v) $o->$k = $v
$out[$row['id'] ?? count($out)] = $o
}
return $out
}
if (($mode & \PDO::FETCH_CLASS) === \PDO::FETCH_CLASS){
$out = []
foreach ($this->data AS $row){
$o = new obj
foreach ((array)$row AS $k => $v) $o->$k = $v
$out[] = $o
}
return $out
}
return $this->datamethod
%JSON_result -> fetchObject ($class = 'obj')
line 44
Haal een enkel object van de opgegeven klasse op uit de JSON-resultaatgegevens, waarbij de eigenschappen van het object worden gekoppeld aan de waarden in de eerste rij van de gegevens.
if (!$this->data) return null
$row = reset($this->data)
$o = new $class
foreach ((array)$row AS $k => $v) $o->$k = $v
return $omethod
%JSON_result -> fetch ($mode = 2)
line 52
Haal een resultaatrij op uit de JSON-gegevens, waarbij ofwel de hele rij of een specifieke kolom wordt geretourneerd op basis van de opgegeven modus.
if (!$this->data) return null
$row = reset($this->data)
if ($mode === \PDO::FETCH_COLUMN) return reset((array)$row)
return $rowmethod
%JSON_result -> fetchColumn ($col = 0)
line 59
Haal een enkele kolom op uit de eerste rij van de JSON-resultaatset en retourneer de waarde op de opgegeven kolomindex of false als deze niet is gevonden.
if (!$this->data) return false
$row = reset($this->data)
$vals = array_values((array)$row)
return $vals[$col] ?? falsemethod
%JSON_result -> rowCount
line 66
Geeft het aantal rijen in de JSON-resultaatset terug.
count($this->data)object
%model
/phlo/resources/DB/model.phlo
static
model :: DB
line 11
Deze eigenschap geeft toegang tot de database-engineconfiguratie voor het model en genereert een fout als er geen is geconfigureerd.
error('No database engine configured for '.static::class)static
model :: objCache
line 12
De model::$objCache-eigenschap bevat een cache voor modelobjecten, waardoor de prestaties worden verbeterd door de noodzaak om dezelfde gegevens herhaaldelijk op te halen te verminderen.
falsestatic
model :: objRecordLimit
line 13
Stelt het maximale aantal records in dat door het model kan worden opgehaald.
10000static
model :: objAudit
line 14
De `model::$objAudit` eigenschap wordt gebruikt om het auditobject dat aan het model is gekoppeld te benaderen, waardoor het mogelijk is om wijzigingen en aanpassingen bij te houden.
falsestatic
model :: objValidate
line 15
De model::$objValidate-eigenschap geeft aan of de objectvalidatie is in- of uitgeschakeld, en retourneert false als de validatie niet actief is.
falsestatic
model :: idColumn
line 16
De model::$idColumn-eigenschap geeft de naam van de identificatiekolom aan die in het model wordt gebruikt, standaard 'id'.
'id'static
model :: idType
line 17
Definieert het gegevenstype voor de identifier van het model als een geheel getal.
'int'static
model :: canView
line 19
Deze eigenschap geeft aan of de huidige gebruiker toestemming heeft om het model te bekijken.
truestatic
model :: canCreate
line 20
De model::$canCreate-eigenschap geeft aan of er een nieuwe instantie van het model kan worden gemaakt.
truestatic
model :: canChange
line 21
Deze eigenschap geeft aan of het model kan worden gewijzigd, en retourneert true als wijzigingen zijn toegestaan.
truestatic
model :: canDelete
line 22
De model::$canDelete-eigenschap geeft aan of de modelinstantie kan worden verwijderd.
truestatic
model :: state
line 24
De `model::$state` eigenschap bevat de huidige staat van het model, inclusief metadata, records en fouten.
%req->model ??= obj(meta: [], records: [], errors: [])static
model :: columns
line 25
Haal de kolommen op die in het model zijn gedefinieerd, hetzij vanuit de static::$columns-eigenschap of door de schema-methode aan te roepen als deze bestaat.
if (isset(static::$columns)) return static::$columns
if (!method_exists(static::class, 'schema')) return static::$table.'.*'
$state = static::state()
$key = spl_object_id(static::DB()).':'.static::DB()->fieldQuotes.':'.static::$table
return $state->meta[static::class]['columns'][$key] ??= static::_columns()static
model :: _columns
line 32
Haal de kolomnamen op van de bijbehorende database-tabel van het model, geformatteerd met veldquotes.
$fq = static::DB()->fieldQuotes
$list = array_merge(...array_values(array_filter(loop(static::fields(), fn($field) => loop($field->objColumns, fn($col) => static::$table."$fq.$fq".$col)))))
return $fq.implode("$fq,$fq", $list).$fqstatic
model :: fields
line 37
Geeft de velden terug die zijn gedefinieerd in het schema van het model, of een lege array als er geen schema bestaat. Als het schema beschikbaar is, worden de velden opgehaald uit de metadata van de status van het model.
if (!method_exists(static::class, 'schema')) return static::$fields ?? []
$state = static::state()
return $state->meta[static::class]['fields'] ??= static::_fields()static
model :: _fields
line 42
Deze eigenschap haalt de velden op die in het schema van het model zijn gedefinieerd, waarbij wordt gegarandeerd dat geen van de veldnamen in conflict komt met gereserveerde trefwoorden.
$reserved = ['table','order','fields','columns','create','change','delete','records','record','column','item','pair','DB','objCache','objState','objSave','objGet','objAudit','objValidate','objErrors','idColumn','idType']
$fields = loop(static::schema(), fn($field, $column) => last($field->name ??= $column, $field->type === 'parent' && $field->obj ??= $column, $field))
foreach ($reserved AS $word) isset($fields[$word]) && error("Reserved column name '$word' in ".static::class)
return $fieldsstatic
model :: field ($name)
line 48
Toegang tot een specifiek veld dat is gedefinieerd in de statische veldenarray van het model met de opgegeven naam.
static::fields()[$name]static
model :: create (...$args)
line 50
Maakt een nieuwe instantie van het model, valideert de invoerargumenten en voert eventuele gedefinieerde levenscyclusmethoden uit voordat het record in de database wordt opgeslagen.
$class = static::class
if (static::objValidate() && !static::objRunValidation($args)) return null
$record = new $class(...$args)
method_exists(static::class, 'beforeSave') && $record->beforeSave()
method_exists(static::class, 'beforeCreate') && $record->beforeCreate()
$pk = static::idColumn()
return static::objAudit() ? static::transaction(fn() => static::objCreateCommit($record, $pk)) : static::objCreateCommit($record, $pk)static
model :: objCreateCommit ($record, $pk)
line 60
Maakt een nieuw record in het model en activeert de afterCreate- en afterSave-methoden als ze bestaan, terwijl ook de creatieactiviteit voor auditdoeleinden wordt vastgelegd.
$id = static::createRecord(...$record)
$record = static::record(...[$pk => $record->$pk ?? $id])
method_exists(static::class, 'afterCreate') && $record->afterCreate()
method_exists(static::class, 'afterSave') && $record->afterSave()
static::objAudit() && audit::log($record, 'create', [], $record->objData)
return $recordstatic
model :: objRunValidation ($data)
line 69
Valideert de verstrekte gegevens tegen de gedefinieerde velden van het model en verzamelt eventuele fouten die tijdens het validatieproces worden aangetroffen.
$errors = []
$fields = static::fields()
foreach ($data AS $column => $value){
if (!($field = $fields[$column] ?? null) || !method_exists($field, 'objValidate')) continue
if ($error = $field->objValidate($value)) $errors[$column] = $error
}
static::state()->errors[static::class] = $errors
return empty($errors)static
model :: objErrors
line 80
Haal de foutmeldingen op die zijn gekoppeld aan de huidige modelinstantie, en retourneer een lege array als er geen zijn gevonden.
static::state()->errors[static::class] ?? []static
model :: createRecord (...$args)
line 81
Maakt een nieuw record aan in de opgegeven database tabel met de meegeleverde argumenten.
static::DB()->create(static::$table, ...$args)static
model :: change ($where, ...$args)
line 82
Deze methode behandelt de wijzigingsoperatie voor een model, voert indien nodig een audit uit en logt updates naar de database.
if (!static::objAudit()) return static::DB()->change(static::$table, $where, ...$args)
$pk = static::idColumn()
$bindings = array_values(array_filter($args, 'is_int', ARRAY_FILTER_USE_KEY))
return static::transaction(function() use ($where, $args, $bindings, $pk){
$old = static::DB()->query('SELECT '.static::$table.'.* FROM '.static::$table.' WHERE '.$where, ...$bindings)->fetchAll(\PDO::FETCH_CLASS, static::class)
$result = static::DB()->change(static::$table, $where, ...$args)
foreach ($old AS $record){
$fresh = static::record(...[$pk => $record->$pk])
$fresh && audit::log($fresh, 'update', $record->objData, $fresh->objData)
}
return $result
})static
model :: delete ($where, ...$args)
line 97
Verwijdert records uit de database-tabel die aan het model is gekoppeld, waarbij de methoden 'beforeDelete' en 'afterDelete' worden aangeroepen als ze bestaan, en waarbij auditing en transacties indien nodig worden afgehandeld.
if (method_exists(static::class, 'beforeDelete') || method_exists(static::class, 'afterDelete') || static::objAudit()){
$records = static::DB()->query('SELECT '.static::$table.'.* FROM '.static::$table.' WHERE '.$where, ...$args)->fetchAll(\PDO::FETCH_CLASS, static::class)
foreach ($records AS $record) method_exists(static::class, 'beforeDelete') && $record->beforeDelete()
return static::objAudit() ? static::transaction(fn() => static::objDeleteCommit($where, $args, $records)) : static::objDeleteCommit($where, $args, $records)
}
return static::DB()->delete(static::$table, $where, ...$args)static
model :: objDeleteCommit ($where, $args, $records)
line 106
Verwijdert een record uit de database op basis van de opgegeven voorwaarden en voert een optionele na-verwijdermethode uit voor elk record, waarbij de verwijdering wordt gelogd als auditing is ingeschakeld.
$result = static::DB()->delete(static::$table, $where, ...$args)
foreach ($records AS $record){
method_exists(static::class, 'afterDelete') && $record->afterDelete()
static::objAudit() && audit::log($record, 'delete', $record->objData, [])
}
return $resultstatic
model :: objLogChange ($where, ...$args)
line 115
Logt wijzigingen aan het opgegeven modelobject, waarbij de staat voor en na de aanpassingen wordt vastgelegd.
static::change($where, ...$args)method
%model -> objSave
line 117
Slaat het huidige object op in de database, waarbij zowel nieuwe als bestaande records worden behandeld met de juiste hooks voor voor- en na-opslagbewerkingen.
$pk = static::idColumn()
$pkValue = $this->$pk ?? $this->id ?? null
$pkValue || error('Can\'t save '.static::class.' record without '.$pk)
// Hooks receive the persisted row as $old, never a clone of the already-mutated object.
$old = static::record(...[$pk => $pkValue])
$isNew = !$old
method_exists(static::class, 'beforeSave') && $this->beforeSave($old)
if ($isNew){
method_exists(static::class, 'beforeCreate') && $this->beforeCreate()
$saved = static::objAudit() ? static::transaction(fn() => $this->objSaveCreate($pk, $pkValue)) : $this->objSaveCreate($pk, $pkValue)
}
else {
method_exists(static::class, 'beforeChange') && $this->beforeChange($old)
static::change($pk.'=?', $pkValue, ...$this)
$saved = static::record(...[$pk => $pkValue])
method_exists(static::class, 'afterChange') && $saved->afterChange($old)
}
method_exists(static::class, 'afterSave') && $saved->afterSave($old)
return $savedmethod
%model -> objSaveCreate ($pk, $pkValue)
line 139
Maakt een nieuw record in het model en voert post-creatieacties uit indien gedefinieerd, zoals loggen en auditen.
static::createRecord(...$this)
$saved = static::record(...[$pk => $pkValue])
method_exists(static::class, 'afterCreate') && $saved->afterCreate()
static::objAudit() && audit::log($saved, 'create', [], $saved->objData)
return $savedstatic
model :: transaction ($callback)
line 147
Voert een database-transactie uit met de opgegeven callbackfunctie, waarbij wordt gegarandeerd dat alle bewerkingen binnen de transactie succesvol worden voltooid voordat deze wordt bevestigd.
static::DB()->transaction($callback)static
model :: query
line 148
Voert een query uit op de database van het model en retourneert de resultaten op basis van de opgegeven voorwaarden.
phlo('query', class: static::class)static
model :: column (...$args)
line 150
Toegang tot een specifieke kolom van de records die door het model zijn geladen, met behulp van de fetchAll-methode met de FETCH_COLUMN-optie van PDO.
static::recordsLoad($args, 'fetchAll', [\PDO::FETCH_COLUMN])static
model :: item (...$args)
line 151
Laadt records uit de database met de opgegeven argumenten en fetch-modus, en retourneert een enkele kolom met gegevens.
static::recordsLoad($args, 'fetch', [\PDO::FETCH_COLUMN])static
model :: pair (...$args)
line 152
Laadt records uit de database als een sleutel-waarde paar array met de opgegeven fetch-modus.
static::recordsLoad($args, 'fetchAll', [\PDO::FETCH_KEY_PAIR])static
model :: records (...$args)
line 153
Haal alle records op uit het model, en laad ze als instanties van de modelklasse.
static::recordsLoad($args, 'fetchAll', [\PDO::FETCH_CLASS|\PDO::FETCH_UNIQUE, static::class], true)static
model :: recordCount (...$args)
line 154
Geeft het totale aantal records in de database-tabel van het model terug.
static::item(...$args, columns: 'COUNT('.static::idColumn().')')static
model :: record (...$args)
line 155
Haal een enkel record op uit de records van het model op basis van de opgegeven argumenten, en retourneer een fout als er meerdere records worden gevonden.
count($records = static::records(...$args)) > 1 ? error('Multiple records for '.static::class) : (current($records) ?: null)static
model :: recordsLoad ($args, $fetch, $fetchMode, $saveRelations = false)
line 157
Laadt records uit de database op basis van opgegeven argumenten en cache-opties, terwijl optioneel gerelateerde records in de status worden opgeslagen.
$pk = static::idColumn()
$args['table'] ??= static::$table
$saveRelations && $args['columns'] ??= static::$table.'.'.$pk.' as _,'.static::columns()
isset(static::$joins) && debug && error('DEPRECATED: static $joins in '.static::class.'. Use getParent/getChildren/getMany instead.')
isset(static::$joins) && $args['joins'] = static::$joins.(isset($args['joins']) ? " $args[joins]" : void)
method_exists(static::class, 'where') && $args['where'] = static::where().(isset($args['where']) ? " AND $args[where]" : void)
isset(static::$group) && $args['group'] ??= static::$group
isset(static::$order) && $args['order'] ??= static::$order
if ($cacheKey = $args['cacheKey'] ?? null) unset($args['cacheKey'])
if ($duration = $args['cache'] ?? static::objCache()){
unset($args['cache'])
$cacheArgs = $args
ksort($cacheArgs)
$records = apcu($cacheKey ?? static::class.slash.md5(json_encode($cacheArgs)), fn() => static::DB()->load(...$args)->$fetch(...$fetchMode), $duration === true ? 86400 : $duration)
}
else $records = static::DB()->load(...$args)->$fetch(...$fetchMode)
if ($saveRelations && $records){
$state = static::state()
$state->records[static::class] = array_replace($state->records[static::class] ?? [], array_column($records, null, $pk))
count($state->records[static::class]) > static::objRecordLimit() && $state->records[static::class] = array_slice($state->records[static::class], -static::objRecordLimit(), preserve_keys: true)
}
return $recordsstatic
model :: objRel ($key)
line 182
Toegang tot het relatie-object dat in het model is gedefinieerd, en retourneert metadata of roept een methode aan als deze bestaat.
$state = static::state()
return $state->meta[static::class][$key] ??= method_exists(static::class, $key) ? static::$key() : static::$$key ?? []prop
%model -> objState
line 187
De `$objState`-eigenschap van het model bevat de staat van het object, inclusief zijn ouders, kinderen en veel-relaties, geïnitieerd als lege arrays.
['parents' => [], 'children' => [], 'many' => []]method
%model -> objGet ($key)
line 188
Haal een object op dat is gekoppeld aan de opgegeven sleutel vanuit de ouder-, kind- of vele relaties in het model.
$this->getParent($key) ?? $this->getChildren($key) ?? $this->getMany($key)method
%model -> objIn ($ids, $db = null)
line 189
Geeft een geciteerde lijst van ID's uit de database of 'NULL' als er geen ID's zijn opgegeven.
$ids ? ($db ?? static::DB())->quoteList($ids) : 'NULL'method
%model -> objMirror (string $bucket, $key)
line 194
Deze methode synchroniseert de staat van een object met een canonieke versie op basis van een opgegeven bucket en sleutel, zodat de staat van het object eventuele wijzigingen in het canonieke object weerspiegelt.
$pk = $this->objData[static::idColumn()] ?? null
if ($pk === null) return
$canonical = static::state()->records[static::class][$pk] ?? null
if (!$canonical || $canonical === $this) return
if (array_key_exists($key, $this->objState[$bucket] ?? [])) return
if (array_key_exists($key, $canonical->objState[$bucket] ?? [])) $this->objState[$bucket][$key] = $canonical->objState[$bucket][$key]method
%model -> getParent ($key)
line 203
Haal het bovenliggende object op dat is gekoppeld aan een gegeven sleutel uit de status van het model, en laad het indien nodig.
if (array_key_exists($key, $this->objState['parents'])) return $this->objState['parents'][$key]
$state = static::state()
$parents = self::objRel('objParents')
if (!$relation = $parents[$key] ?? null) return
$isArray = is_array($relation)
$class = $isArray ? $relation['obj'] : $relation
$column = $isArray ? $relation['key'] ?? $key : $key
if (!$parentId = $this->objData[$column] ?? null) return $this->objState['parents'][$key] = null
if (!isset($state->records[$class][$parentId])){
$idsToLoad = [$parentId => true]
$allObjData = array_map(fn($record) => $record->objData, $state->records[static::class] ?? [])
foreach ($parents as $pKey => $pRelation){
$pIsArray = is_array($pRelation)
$pClass = $pIsArray ? $pRelation['obj'] : $pRelation
if ($pClass === $class) foreach (array_column($allObjData, $pIsArray ? $pRelation['key'] ?? $pKey : $pKey) as $pId) $pId && !isset($state->records[$class][$pId]) && $idsToLoad[$pId] = true
}
if ($idsToLoad = array_keys($idsToLoad)) $class::records(where: $class::idColumn().' IN ('.$this->objIn($idsToLoad, $class::DB()).')')
}
$parentObject = $state->records[$class][$parentId] ?? null
return $this->objState['parents'][$key] = $parentObjectmethod
%model -> getChildren ($key)
line 226
Haal de kindobjecten op die zijn gekoppeld aan een bepaalde sleutel uit de status van het model, en laad ze indien nodig.
if (array_key_exists($key, $this->objState['children'])) return $this->objState['children'][$key]
$state = static::state()
if (!$relation = self::objRel('objChildren')[$key] ?? null) return
$isArray = is_array($relation)
$class = $isArray ? $relation['obj'] : $relation
$column = $isArray ? $relation['key'] : static::objShortName()
$toLoad = array_filter($state->records[static::class] ?? [], fn($p) => !array_key_exists($key, $p->objState['children']))
if ($toLoad){
$fq = $class::DB()->fieldQuotes
$children = $class::records(where: $fq.$column.$fq.' IN ('.$this->objIn(array_keys($toLoad), $class::DB()).')')
foreach ($toLoad AS $parentRecord) $parentRecord->objState['children'][$key] = []
foreach ($children AS $childId => $child) !is_null($pId = $child->objData[$column] ?? null) && isset($state->records[static::class][$pId]) && $state->records[static::class][$pId]->objState['children'][$key][$childId] = $child
}
$this->objMirror('children', $key)
return $this->objState['children'][$key] ?? []method
%model -> getMany ($key)
line 244
Haal meerdere gerelateerde records op op basis van een opgegeven sleutel uit de status van het model, en laad ze indien ze nog niet aanwezig zijn.
if (array_key_exists($key, $this->objState['many'])) return $this->objState['many'][$key]
$state = static::state()
if (!$relation = self::objRel('objMany')[$key] ?? null) return
$class = $relation['obj']
$toLoad = array_filter($state->records[static::class] ?? [], fn($p) => !array_key_exists($key, $p->objState['many']))
if ($toLoad){
$fq = static::DB()->fieldQuotes
$lk = $relation['localKey']
$fk = $relation['foreignKey']
$pivotRows = static::DB()->rows(table: $relation['table'], columns: $fq.$lk.$fq.comma.$fq.$fk.$fq, where: $fq.$lk.$fq.' IN ('.$this->objIn(array_keys($toLoad)).')')
$targetIds = array_unique(array_map(fn($row) => $row->{$relation['foreignKey']}, $pivotRows ?: []))
$targetRecords = $targetIds ? $class::records(where: $class::idColumn().' IN ('.$this->objIn($targetIds, $class::DB()).')') : []
foreach ($toLoad AS $parentRecord) $parentRecord->objState['many'][$key] = []
foreach ($pivotRows ?: [] AS $row){
$parentId = $row->$lk
$foreignId = $row->$fk
if (isset($state->records[static::class][$parentId]) && isset($targetRecords[$foreignId])) $state->records[static::class][$parentId]->objState['many'][$key][$foreignId] = $targetRecords[$foreignId]
}
}
$this->objMirror('many', $key)
return $this->objState['many'][$key] ?? []method
%model -> getCount ($key)
line 268
Haal het aantal gerelateerde records op voor een gegeven sleutel, waarbij indien nodig gegevens uit de database worden geladen en het resultaat in de status van het object wordt gecached.
if (array_key_exists($key, $this->objState['counts'] ?? [])) return $this->objState['counts'][$key]
$state = static::state()
if ($relation = self::objRel('objChildren')[$key] ?? null){
$toLoad = array_filter($state->records[static::class] ?? [], fn($p) => !array_key_exists($key, $p->objState['counts'] ?? []))
if ($toLoad){
$isArray = is_array($relation)
$class = $isArray ? $relation['obj'] : $relation
$column = $isArray ? $relation['key'] : static::objShortName()
$fq = $class::DB()->fieldQuotes
$counts = $class::pair(columns: $fq.$column.$fq.', COUNT(*)', where: $fq.$column.$fq.' IN ('.$this->objIn(array_keys($toLoad), $class::DB()).')', group: $fq.$column.$fq)
foreach ($toLoad as $id => $record) $record->objState['counts'][$key] = (int)($counts[$id] ?? 0)
}
$this->objMirror('counts', $key)
return $this->objState['counts'][$key] ?? 0
}
if ($relation = self::objRel('objMany')[$key] ?? null){
$toLoad = array_filter($state->records[static::class] ?? [], fn($p) => !array_key_exists($key, $p->objState['counts'] ?? []))
if ($toLoad){
$fq = static::DB()->fieldQuotes
$localKey = $relation['localKey']
$counts = static::DB()->load(table: $relation['table'], columns: $fq.$localKey.$fq.',COUNT(*)', where: $fq.$localKey.$fq.' IN ('.$this->objIn(array_keys($toLoad)).')', group: $fq.$localKey.$fq)->fetchAll(\PDO::FETCH_KEY_PAIR)
foreach ($toLoad as $id => $record) $record->objState['counts'][$key] = (int)($counts[$id] ?? 0)
}
$this->objMirror('counts', $key)
return $this->objState['counts'][$key] ?? 0
}
return 0method
%model -> getLast ($key)
line 298
Haal het laatste kindobject op dat is gekoppeld aan de opgegeven sleutel uit de status van het model, en laad het indien nodig.
if (array_key_exists($key, $this->objState['last_child'] ?? [])) return $this->objState['last_child'][$key]
$state = static::state()
if ($relation = self::objRel('objChildren')[$key] ?? null){
$toLoad = array_filter($state->records[static::class] ?? [], fn($p) => !array_key_exists($key, $p->objState['last_child'] ?? []))
if ($toLoad){
$isArray = is_array($relation)
$class = $isArray ? $relation['obj'] : $relation
$column = $isArray ? $relation['key'] : static::objShortName()
$childTable = $class::$table
$fq = $class::DB()->fieldQuotes
$qt = $fq.$childTable.$fq
$qc = $fq.$column.$fq
$ids = $this->objIn(array_keys($toLoad), $class::DB())
$childPk = $class::idColumn()
$joins = ' INNER JOIN (SELECT MAX('.$fq.$childPk.$fq.') AS last_id, '.$qc.' AS parent_id FROM '.$qt.' WHERE '.$qc.' IN ('.$ids.') GROUP BY '.$qc.') AS lcmax ON '.$qt.'.'.$fq.$childPk.$fq.' = lcmax.last_id'
$lastChildren = $class::records(joins: $joins)
foreach ($toLoad as $record) $record->objState['last_child'][$key] = null
foreach ($lastChildren as $child) if (isset($state->records[static::class][$parentId = $child->objData[$column]])) $state->records[static::class][$parentId]->objState['last_child'][$key] = $child
}
$this->objMirror('last_child', $key)
return $this->objState['last_child'][$key] ?? null
}
return nullstatic
model :: objResolveClass ($name)
line 324
Lost de klassenaam op voor het opgegeven modelobject, waardoor dynamische klasseverwerking in Phlo mogelijk is.
$namestatic
model :: objShortName ($class = null)
line 325
Deze expressie haalt de naam van de huidige modelklasse op of de opgegeven klasse als deze bestaat, met gebruik van de statische context.
$class ?? static::classstatic
model :: objParents
line 327
Geeft de ouderobjecten terug die zijn gekoppeld aan het huidige model, met gebruik van het gedefinieerde schema en het filteren van velden van het type 'parent'.
if (property_exists(static::class, 'objParents')) return static::$objParents
if (!method_exists(static::class, 'schema')) return []
return loop(array_filter(static::fields(), fn($f) => $f->type === 'parent'), fn($f, $c) => $f->key ? arr(obj: static::objResolveClass($f->obj), key: $f->key) : (static::objResolveClass($f->obj ?? $c)))static
model :: objChildren
line 333
Geeft de kindobjecten terug die zijn gekoppeld aan het huidige model, waarbij het gedefinieerde schema wordt gebruikt en velden van het type 'child' worden gefilterd.
if (property_exists(static::class, 'objChildren')) return static::$objChildren
if (!method_exists(static::class, 'schema')) return []
return loop(array_filter(static::fields(), fn($f) => $f->type === 'child'), fn($f, $c) => $f->key ? arr(obj: static::objResolveClass($f->obj), key: $f->key) : (static::objResolveClass($f->obj ?? $c)))static
model :: objMany
line 339
Geeft de 'objMany'-eigenschap terug als deze bestaat; anders wordt een array van gerelateerde objecten op basis van de schema-definitie opgehaald.
if (property_exists(static::class, 'objMany')) return static::$objMany
if (!method_exists(static::class, 'schema')) return []
return loop(array_filter(static::fields(), fn($f) => $f->type === 'many'), fn($f) => arr(obj: static::objResolveClass($f->obj), table: $f->table, localKey: $f->localKey ?? static::objShortName(), foreignKey: $f->foreignKey ?? $f->obj))object
%MySQL
/phlo/resources/DB/MySQL.phlo
prop
%MySQL -> PDO
line 11
Maakt een nieuwe PDO-instantie aan voor het verbinden met een MySQL-database met behulp van de opgegeven referenties.
new \PDO('mysql:host='.%creds->mysql->host.';dbname='.%creds->mysql->database, %creds->mysql->user, %creds->mysql->password)object
%PostgreSQL
/phlo/resources/DB/PostgreSQL.phlo
prop
%PostgreSQL -> PDO
line 11
Maakt een nieuwe PDO-instantie aan voor het verbinden met een PostgreSQL-database met de opgegeven inloggegevens.
new PDO('pgsql:host='.%creds->postgresql->host.';dbname='.%creds->postgresql->database, %creds->postgresql->user, %creds->postgresql->password)prop
%PostgreSQL -> fieldQuotes
line 12
Geeft de veldnaam terug, omgeven door dubbele aanhalingstekens voor PostgreSQL-compatibiliteit.
dqprop
%PostgreSQL -> insertIgnore
line 13
Voegt een nieuw record toe aan een PostgreSQL-database en negeert de bewerking als er al een record met dezelfde unieke sleutel bestaat.
voidprop
%PostgreSQL -> insertOnConflict
line 14
Voegt een nieuw record toe aan een PostgreSQL-database, en als er een conflict optreedt (bijv. een duplicaat sleutel), doet het niets in plaats van een fout te genereren.
' ON CONFLICT DO NOTHING'method
%PostgreSQL -> lastId
line 16
Haal de laatst ingevoegde ID op uit de PostgreSQL-database, met gebruik van een savepoint om de integriteit van de transactie te waarborgen.
$savepoint = $this->PDO->inTransaction()
$savepoint && $this->PDO->exec('SAVEPOINT phlo_lastid')
try {
$id = $this->PDO->lastInsertId()
} catch (\Throwable $e){
$id = false
}
if ($savepoint) $this->PDO->exec($id === false ? 'ROLLBACK TO SAVEPOINT phlo_lastid' : 'RELEASE SAVEPOINT phlo_lastid')
return $idobject
%Qdrant
/phlo/resources/DB/Qdrant.phlo
method
%Qdrant -> get (string $input, ?string $model = null)
line 10
Haal een embedding op voor de gegeven invoerstring met behulp van het opgegeven model, en cache het resultaat gedurende 28 dagen.
apcu('embedding/'.token(input: $input), fn($input) => %AI->embedding(input: $input, model: $model), 86400 * 28)method
%Qdrant -> collections
line 12
Haal een array van collectie namen op uit de Qdrant API-respons.
array_column($this->request('collections')->result->collections, 'name')method
%Qdrant -> create ($collection, $size = 1536, $distance = 'Cosine')
line 13
Maakt een nieuwe collectie aan in Qdrant met de opgegeven vectorgrootte en afstandsmetrieken.
$this->request("collections/$collection", PUT: arr(vectors: arr(size: $size, distance: $distance)))->status === 'ok'method
%Qdrant -> upsert ($collection, $id, $input, ...$payload)
line 14
Deze functie werkt een punt bij of voegt een punt toe in een opgegeven Qdrant-collectie met behulp van de opgegeven ID en invoervector, samen met optionele payloadgegevens.
$this->request("collections/$collection/points", PUT: arr(points: [arr(id: $id, vector: $this->get($input), payload: $payload ?: null)]))->result->operation_idmethod
%Qdrant -> delete ($collection, ...$ids)
line 15
Verwijdert opgegeven punten uit een Qdrant-collectie op basis van hun ID's.
$this->request("collections/$collection/points/delete", POST: arr(points: $ids))->resultmethod
%Qdrant -> search ($collection, $input = null, $top = 100)
line 16
Zoekt naar punten in de opgegeven Qdrant-collectie op basis van de invoervector en retourneert de beste resultaten.
create($this->request("collections/$collection/points/search", POST: arr(vector: is_null($input) ? array_fill(0, 1536, 0) : $this->get($input), top: $top, with_payload: true))->result, fn($record) => $record->id, fn($record) => last($record = array_merge(get_object_vars($record), get_object_vars($record->payload)), obj(...array_filter($record, fn($key) => $key !== 'payload', ARRAY_FILTER_USE_KEY))))method
%Qdrant -> drop ($collection)
line 17
Verwijdert de opgegeven collectie uit Qdrant door een DELETE-verzoek naar de juiste endpoint te sturen.
$this->request("collections/$collection", DELETE: true)->resultmethod
%Qdrant -> request ($uri, ...$data)
line 19
Verzendt een HTTP-verzoek naar de opgegeven Qdrant-server-URI met optionele gegevens en retourneert de gedecodeerde JSON-reactie.
json_decode(HTTP(%creds->qdrant->server.$uri, %creds->qdrant->key ? ['api-key: '.%creds->qdrant->key] : [], true, ...$data))object
%query
/phlo/resources/DB/query.phlo
prop
%query -> class
line 10
Haal het type van de huidige query-object op.
prop
%query -> conditions
line 11
Definieert voorwaarden voor het filteren van resultaten in een query.
[]prop
%query -> bindings
line 12
De `query->$bindings` haalt de bindings op die aan een query zijn gekoppeld in Phlo, waardoor toegang wordt verkregen tot de parameters die zijn gebruikt bij de uitvoering van de query.
[]prop
%query -> orderBy
line 13
Geeft het veld op waarop de resultaten van een query moeten worden gesorteerd.
prop
%query -> limitVal
line 14
Stelt het maximale aantal resultaten in dat uit een query in Phlo moet worden geretourneerd.
prop
%query -> offsetVal
line 15
Haal de huidige offsetwaarde op voor paginering in een query.
method
%query -> fq
line 16
Deze expressie haalt de veldquotes op uit de databaseklasse die aan de huidige instantie is gekoppeld, of valt terug op 'bt' als de klasse niet is ingesteld.
($class = $this->class) ? $class::DB()->fieldQuotes : btmethod
%query -> q ($column)
line 17
Valideert de opgegeven kolomnaam voor de query builder en formatteert deze door elk deel te omringen met de volledig gekwalificeerde naam.
preg_match('/^[A-Za-z_][A-Za-z0-9_.]*$/', $column) || error("Invalid column for query builder: $column")
$fq = $this->fq
return implode(dot, array_map(fn($part) => $fq.$part.$fq, explode(dot, $column)))method
%query -> eq ($column, $value)
line 23
Filtert de queryresultaten om alleen diegene op te nemen waar de opgegeven kolom gelijk is aan de gegeven waarde.
$this->where($this->q($column)." = ?", $value)method
%query -> neq ($column, $value)
line 24
Filtert resultaten waarbij de opgegeven kolom niet gelijk is aan de gegeven waarde.
$this->where($this->q($column)." != ?", $value)method
%query -> gt ($column, $value)
line 25
Voegt een voorwaarde toe aan de query die resultaten filtert waarbij de opgegeven kolom groter is dan de gegeven waarde.
$this->where($this->q($column)." > ?", $value)method
%query -> gte ($column, $value)
line 26
Genereert een queryvoorwaarde die controleert of de waarde van de opgegeven kolom groter dan of gelijk is aan een gegeven waarde.
$this->where($this->q($column)." >= ?", $value)method
%query -> lt ($column, $value)
line 27
Voegt een voorwaarde toe aan de query om resultaten te filteren waarbij de opgegeven kolom kleiner is dan de gegeven waarde.
$this->where($this->q($column)." < ?", $value)method
%query -> lte ($column, $value)
line 28
Voegt een voorwaarde toe aan de query die resultaten filtert waarbij de opgegeven kolom kleiner dan of gelijk is aan de gegeven waarde.
$this->where($this->q($column)." <= ?", $value)method
%query -> like ($column, $value)
line 29
Voegt een voorwaarde toe aan de query die controleert of de opgegeven kolom een waarde bevat die lijkt op de opgegeven waarde met behulp van de SQL LIKE-operator.
$this->where($this->q($column)." LIKE ?", $value)method
%query -> in ($column, array $values)
line 30
Voegt een voorwaarde toe aan de query om resultaten te filteren waarbij de waarde van de opgegeven kolom in de opgegeven array van waarden staat.
$this->where($this->q($column)." IN (".implode(comma, array_fill(0, count($values), qm)).")", ...$values)method
%query -> isNull ($column)
line 31
Controleert of de opgegeven kolom in de query null is.
$this->where($this->q($column)." IS NULL")method
%query -> notNull ($column)
line 32
Voegt een voorwaarde toe aan de query om ervoor te zorgen dat de opgegeven kolom niet null is.
$this->where($this->q($column)." IS NOT NULL")method
%query -> between ($column, $min, $max)
line 33
Filtert resultaten om alleen diegene op te nemen waarbij de waarde van de opgegeven kolom tussen de gegeven minimum- en maximumwaarden ligt.
$this->where($this->q($column)." BETWEEN ? AND ?", $min, $max)method
%query -> raw ($sql, ...$bindings)
line 34
Voert een ruwe SQL-query uit met de opgegeven bindings, waardoor dynamische queryconstructie mogelijk is.
$this->where($sql, ...$bindings)method
%query -> where ($condition, ...$values)
line 35
Voegt een voorwaarde toe aan de query met de opgegeven waarden voor binding. Het maakt dynamische filtering van resultaten mogelijk op basis van de opgegeven voorwaarde.
$this->conditions[] = $condition
foreach ($values AS $v) $this->bindings[] = $v
return $thismethod
%query -> order ($order)
line 41
Stelt de volgorde voor de query in met de opgegeven $order-waarde en retourneert de huidige instantie.
$this->orderBy = $order
return $thismethod
%query -> limit ($limit)
line 46
Stelt het maximum aantal resultaten in dat uit een query moet worden geretourneerd, gedefinieerd door de $limit parameter.
$this->limitVal = $limit
return $thismethod
%query -> offset ($offset)
line 51
Stelt de offsetwaarde voor de query in, waardoor paginering van resultaten mogelijk is.
$this->offsetVal = $offset
return $thismethod
%query -> build
line 55
Bouwt een argumentarray voor een query op basis van opgegeven voorwaarden, volgorde, limiet en bindingen voor gebruik in databasebewerkingen.
$where = $this->conditions ? implode(' AND ', $this->conditions) : void
$limit = $this->limitVal ? ($this->offsetVal ? "$this->offsetVal,$this->limitVal" : "$this->limitVal") : void
$args = ['where' => $where ?: void, 'order' => $this->orderBy ?: void, 'limit' => $limit ?: void]
foreach ($this->bindings AS $b) $args[] = $b
return $argsprop
%query -> records
line 63
Haal een verzameling records op uit de opgegeven klasse met behulp van de verstrekte bouwparameters.
($class = $this->class) && $class::records(...$this->build)prop
%query -> record
line 64
Haal een record op uit de opgegeven klasse met behulp van de verstrekte bouwparameters.
($class = $this->class) && $class::record(...$this->build)prop
%query -> column
line 65
Toegang tot een specifieke kolom van een queryresultaatset met behulp van de gedefinieerde klasse en buildparameters.
($class = $this->class) && $class::column(...$this->build)prop
%query -> item
line 66
Haal een item op uit een klasse met behulp van de opgegeven bouwparameters.
($class = $this->class) && $class::item(...$this->build)prop
%query -> count
line 67
Geeft het totale aantal records in de opgegeven klasse terug met behulp van de recordCount-methode.
($class = $this->class) && $class::recordCount(...$this->build)method
%query -> delete
line 68
Verwijdert records uit de database op basis van opgegeven voorwaarden. Als er geen voorwaarden zijn opgegeven, wordt er een foutmelding weergegeven.
$class = $this->class
$where = $this->conditions ? implode(' AND ', $this->conditions) : error('Cannot delete without conditions')
return $class::delete($where, ...$this->bindings)object
%SQLite
/phlo/resources/DB/SQLite.phlo
static
SQLite :: __handle
line 11
Deze eigenschap bevat de handle naar de SQLite-databaseverbinding, waarmee interactie met de database mogelijk is.
"SQLite/$file"method
%SQLite -> __construct (private string $file)
line 12
Initialiseert een nieuwe SQLite-instantie met het opgegeven databasebestand.
prop
%SQLite -> PDO
line 13
Maakt een nieuwe PDO-instantie voor SQLite met het opgegeven bestand.
new PDO('sqlite:'.$this->file)prop
%SQLite -> insertIgnore
line 14
Voegt een nieuw record toe aan de SQLite-database, waarbij de bewerking wordt genegeerd als er al een record met dezelfde primaire sleutel bestaat.
' OR IGNORE'