vlw/php-mysql
1
0
Fork 0
mirror of https://codeberg.org/vlw/php-mysql.git synced 2025-09-13 16:23:42 +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
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
$db->select(
// Sequential array of string with column names to retrieve
// Or null to retrieve a bool if rows were matched
?array $columns
array|string|null $columns
): array|bool;
// 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
```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
```
```
[

5
src/MySQL.php
View file

@ -136,9 +136,12 @@
/* ---- */
// 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();
// Create array of columns from CSV
$columns = is_array($columns) ? $columns : explode(",", $columns);
// Filter columns that aren't in the model if defiend
if ($columns && $this->model) {
$columns = $this->in_model($columns);