Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lozemc/simple-google-sheets
An easy way to manage data in Google Sheets using PHP
https://github.com/lozemc/simple-google-sheets
excel google google-api-client google-api-v4 google-sheets google-sheets-api google-spreadsheets helpers-library library php sheet sheets sheets-api spreadsheet spreadsheets table wrapper
Last synced: about 1 month ago
JSON representation
An easy way to manage data in Google Sheets using PHP
- Host: GitHub
- URL: https://github.com/lozemc/simple-google-sheets
- Owner: lozemc
- License: mit
- Created: 2024-01-02T13:33:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-02-24T17:19:29.000Z (12 months ago)
- Last Synced: 2024-03-25T00:42:04.456Z (11 months ago)
- Topics: excel, google, google-api-client, google-api-v4, google-sheets, google-sheets-api, google-spreadsheets, helpers-library, library, php, sheet, sheets, sheets-api, spreadsheet, spreadsheets, table, wrapper
- Language: PHP
- Homepage:
- Size: 6.84 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GoogleSheet
`GoogleSheet` is a convenient wrapper for the
standard [`google/apiclient`](https://github.com/googleapis/google-api-php-client) package, providing an easy-to-use
interface for working with Google Sheets.
## Installation
Require the package using [Composer](https://packagist.org/packages/lozemc/simple-google-sheets):
```bash
composer require lozemc/simple-google-sheets
```
## Usage
#### Creating an Instance
```php
use Lozemc\GoogleSheet;
// Replace 'your_table_id' and 'path/to/your/credentials-config.json' with actual values
$table_id = 'your_table_id';
$credentials = 'path/to/your/credentials-config.json';
$table = new GoogleSheet($table_id, $credentials);
```
### Setting the Sheet
```php
$table->set_sheet('YourSheetName');
```
### Getting Rows
```php
// Get all rows
$rows = $table->get_rows();
print_r($rows);
// [
// [ 'A1 value', 'B1 value', 'C1 value' ],
// [ 'A2 value', 'B2 value', 'C2 value' ],
// [ 'A3 value', 'B3 value', 'C3 value' ]
// ]
// Get rows from a specific range
$range = 'B2:C3';
$rows = $table->get_rows($range);
print_r($rows);
// [
// [ 'B2 value', 'C2 value' ],
// [ 'B3 value', 'C3 value' ]
// ]
```
### Updating Rows
```php
$table->update([['A1 value', 'B1 value']]);
//
$range = 'A4';
$table->update([['A4 value', 'B4 value']], $range);
//
$table->update([
['A1 value', 'B1 value'],
['A2 value', 'B2 value', 'C3 value'],
['A3 value', 'B3 value', '', 'D4 value'],
]);
```
### Appending Rows
```php
$table->append([['Value 1', 'Value 2']]);
//
$table->append([['Value 1', 'Value 2']], 'A10');
```
### Simple Example
```php
require_once __DIR__ . '/vendor/autoload.php';
use Lozemc\GoogleSheet;
$table_id = '1gncMRlsonFj2YzYw79QnfVA4Go5UcYkmfgG1T7Vb5Q';
$credentials = __DIR__ . '/credentials-config.json';
$table = new GoogleSheet($table_id, $credentials);
// Set the sheet name if not provided during initialization
$table->set_sheet('Sheet1');
// Append new rows
$table->append([
['Lisa', 'Anderson'],
['Jane', 'Jones'],
]);
// Get all rows
$rows = $table->get_rows();
// Display the retrieved rows
print_r($rows);
// Get rows from a specific range in another sheet
$rows = $table->set_sheet('Sheet2')->get_rows('B10:C20');
print_r($rows);
// Update data in a specific range
$table->update([['New value']], 'B10');
$row = $table->get_rows('B10');
print_r($row);
```
## Requirements
- PHP >=7.4.33
## Dependencies
- [google/apiclient ^2.15.0](https://github.com/googleapis/google-api-php-client)
## License
This package is licensed under the [MIT License](LICENSE).