fix: return types for executor methods (#29)

* fix: fix return types for executor methods

* fix(doc): fix return types for executor methods in README
This commit is contained in:
Victor Westerlund 2024-01-08 14:30:51 +01:00 committed by GitHub
parent 03235df47b
commit 4779b8b824
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 7 additions and 7 deletions

View file

@ -58,7 +58,7 @@ use libmysqldriver\MySQL;
$db = new MySQL($host, $user, $pass, $db); $db = new MySQL($host, $user, $pass, $db);
``` ```
All executor methods [`select()`](#select), [`update()`](#update), and [`insert()`](#insert) will return a [`mysqli_result`](https://www.php.net/manual/en/class.mysqli-result.php) object. All executor methods [`select()`](#select), [`update()`](#update), and [`insert()`](#insert) will return a [`mysqli_result`](https://www.php.net/manual/en/class.mysqli-result.php) object or boolean.
# SELECT # SELECT
@ -69,7 +69,7 @@ Pass an associative array of strings, CSV string, or null to this method to filt
```php ```php
$db->select( $db->select(
array|string|null $columns array|string|null $columns
): mysqli_result; ): mysqli_result|bool;
``` ```
In most cases you probably want to select with a constraint. Chain the [`where()`](#where) method before `select()` to filter the query In most cases you probably want to select with a constraint. Chain the [`where()`](#where) method before `select()` to filter the query
@ -119,7 +119,7 @@ Use `MySQL->insert()` to append a new row to a database table
$db->insert( $db->insert(
// Array of values to INSERT // Array of values to INSERT
array $values array $values
): mysqli_result ): mysqli_result|bool
// Returns true if row was inserted // Returns true if row was inserted
``` ```
@ -146,7 +146,7 @@ Modify existing rows with `MySQL->update()`
$db->get( $db->get(
// Key, value array of column names and values to update // Key, value array of column names and values to update
array $fields, array $fields,
): mysqli_result; ): mysqli_result|bool;
// Returns true if at least 1 row was changed // Returns true if at least 1 row was changed
``` ```

View file

@ -183,7 +183,7 @@
*/ */
// Create Prepared Statament for SELECT with optional WHERE filters // Create Prepared Statament for SELECT with optional WHERE filters
public function select(array|string|null $columns = null): mysqli_result { public function select(array|string|null $columns = null): mysqli_result|bool {
$this->throw_if_no_table(); $this->throw_if_no_table();
// Create array of columns from CSV // Create array of columns from CSV
@ -216,7 +216,7 @@
} }
// Create Prepared Statement for UPDATE using PRIMARY KEY as anchor // Create Prepared Statement for UPDATE using PRIMARY KEY as anchor
public function update(array $entity): mysqli_result { public function update(array $entity): mysqli_result|bool {
$this->throw_if_no_table(); $this->throw_if_no_table();
// Make constraint for table model if defined // Make constraint for table model if defined
@ -250,7 +250,7 @@
} }
// Create Prepared Statemt for INSERT // Create Prepared Statemt for INSERT
public function insert(array $values): mysqli_result { public function insert(array $values): mysqli_result|bool {
$this->throw_if_no_table(); $this->throw_if_no_table();
// A value for each column in table model must be provided // A value for each column in table model must be provided