vlw/php-mysql
1
0
Fork 0
mirror of https://codeberg.org/vlw/php-mysql.git synced 2025-09-14 00:33:41 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

feat: accept CSV string as columns for select() (#16)

Browse source 
* feat: accept CSV string as columns for select()

* feat(doc): add string doc for select to README
This commit is contained in:
Victor Westerlund 2023-11-02 11:24:20 +01:00 • committed by GitHub
parent 5abcb48010
commit 13720e772e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 9 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
README.md
View file

@ -59,13 +59,13 @@ $db = new MySQL($host, $user, $pass, $db);
# SELECT # SELECT
Use `MySQL->select()` to retrieve columns from a database table Use `MySQL->select()` to retrieve columns from a database table.
Pass an associative array of strings, CSV string, or null to this method to filter columns.
```php ```php
$db->select( $db->select(
// Sequential array of string with column names to retrieve array|string|null $columns
// Or null to retrieve a bool if rows were matched
?array $columns
): array|bool; ): array|bool;
// Returns array of arrays for each row, or bool if no columns were defined // Returns array of arrays for each row, or bool if no columns were defined
``` ```
@ -75,6 +75,7 @@ In most cases you probably want to select with a constraint. Chain the [`where()
### Example ### Example
```php ```php
$beverages = $db->for("beverages")->select(["beverage_name", "beverage_size"]); // SELECT beverage_name, beverage_size FROM beverages $beverages = $db->for("beverages")->select(["beverage_name", "beverage_size"]); // SELECT beverage_name, beverage_size FROM beverages
$beverages = $db->for("beverages")->select("beverage_name, beverage_size"); // SELECT beverage_name, beverage_size FROM beverages
``` ```
``` ```
[ [

5
src/MySQL.php
View file

@ -136,9 +136,12 @@
/* ---- */ /* ---- */
// Create Prepared Statament for SELECT with optional WHERE filters // Create Prepared Statament for SELECT with optional WHERE filters
public function select(?array $columns = null): array|bool { public function select(array|string|null $columns = null): array|bool {
$this->throw_if_no_table(); $this->throw_if_no_table();
// Create array of columns from CSV
$columns = is_array($columns) ? $columns : explode(",", $columns);
// Filter columns that aren't in the model if defiend // Filter columns that aren't in the model if defiend
if ($columns && $this->model) { if ($columns && $this->model) {
$columns = $this->in_model($columns); $columns = $this->in_model($columns);