basecardhero/spreadsheet

一个用于创建 Google Sheets 的 Google 服务封装库。

v0.3.0 2019-03-13 03:11 UTC

This package is auto-updated.

Last update: 2024-09-16 19:19:16 UTC


README

Build Status codecov License composer.lock

此包是为我正在工作的项目创建的,并不完全支持 Google 服务(或您可能希望的方式)。请随意通过创建拉取请求添加功能。参见 贡献指南

安装

您可以通过 composer 安装此包。

$ composer require basecardhero/spreadsheet

用法

您需要配置 Google 客户端。请参阅 gsuitedevs/php-samples 了解如何为 php 配置 Google 客户端。

示例

创建 Spreadsheet 实例

require_once '/project/path/vendor/autoload.php';


$client = new \Google_Client(); // Make sure to configure your Google client.
$sheetService = new \Google_Service_Sheets($client);
$spreadsheet = new \BaseCardHero\Spreadsheet\Spreadsheet($sheetService);

创建工作表

create() 方法将从 rest 服务获取新的工作表。

$spreadsheet->create()
    ->getSpreadsheet(); // \Google_Service_Sheets_Spreadsheet

检索工作表

retrieve() 方法将从 rest 服务获取现有工作表。

$spreadsheetId = '1b7c48b64ef1d5bf093632e7f8aa6529';

$spreadsheet->retrieve($spreadsheetId)
    ->getSpreadsheet(); // \Google_Service_Sheets_Spreadsheet

设置标题

$spreadsheet->create()
    ->setTitle('My Spreadsheet Title')
    ->getSpreadsheet(); // \Google_Service_Sheets_Spreadsheet

设置列数据

$columns = [
    [
        'range' => 'A1:A',
        'values' => [0, 1, 2, 3]
    ],
    [
        'range' => 'B1:B',
        'values' => ['a', 'b', 'c', 'd']
    ],
];

$spreadsheet->create()
    ->setColumns($columns)
    ->getSpreadsheet(); // \Google_Service_Sheets_Spreadsheet

在工作表中清除数据

$spreadsheet->create()
    ->clearRanges(['A1:A', 'B1:B'])
    ->getSpreadsheet(); // \Google_Service_Sheets_Spreadsheet

从另一个工作表复制工作表

$otherSpreadsheetId = '635d0d664ff92db666a9be5ed84f231c';
$otherSheetId = 0;

$spreadsheet->create()
    ->copySheetFrom($otherSpreadsheetId, $otherSheetId)
    ->getSpreadsheet(); // \Google_Service_Sheets_Spreadsheet

删除工作表中的工作表

$sheetId = 0;

$spreadsheet->create()
    ->deleteSheet($sheetId)
    ->getSpreadsheet(); // \Google_Service_Sheets_Spreadsheet

测试

$ composer all

变更日志

请参阅 变更日志 了解最近的变化。

贡献

请参阅 贡献指南 了解详情。

安全

如果您发现任何安全相关的问题,请通过电子邮件 ryan@basecardhero.com 而不是使用问题跟踪器。

鸣谢

许可协议

MIT 许可协议 (MIT)。请参阅 许可文件 了解更多信息。

PHP 包模板

此包是使用 PHP 包模板 生成的。