README

这是一个 Laravel（4.1 及以上版本）包，通过 artisan 命令从 Google 电子表格生成 Laravel 语言文件。

它将

• 读取类似 这个 格式的电子表格中的数据
• 输出为 Laravel Lang 文件，例如 这些

此库用于简化与 Laravel 框架的接口。实际工作的大部分由关键依赖项完成。

要求

• Laravel >4.1
• PHP >5.4
• Composer 依赖项
  • Google Spreadsheet Exporter - 大部分逻辑都在这里。所以关于电子表格格式和解析方式的大部分文档都可以在这里找到
  • Google 电子表格 API 客户端
  • 官方 Google API 客户端
• 可读的 Google 电子表格
  • 电子表格必须是新格式（即 Google Sheets）才能兼容
  • 必须与客户端电子邮件共享（以下将提供如何生成一个的详细信息）

背景

目标是

• 避免硬编码复制文本
• 减少对复制文本进行编辑时所需的开发周期
• 优雅地处理复制文本的多语言翻译

更多背景信息可以在 Google Spreadsheet Exporter 下找到。特别是，请阅读有关设置 Google API 客户端凭据的说明。

待办事项

• 通过在 Laravel 应用程序中使用来最终确定代码库
• 文档
  • 如何设置 Google API 凭据
  • 使用方法
  • 贡献
• PhpUnit 测试

安装

主要通过 composer 进行安装。

在您的项目中创建一个 composer.json 文件，并添加以下内容

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/asimlqt/php-google-spreadsheet-client"
        },
        {
            "type": "vcs",
            "url": "https://github.com/mechastorm/google-spreadsheet-exporter"
        }
    ],
    "require": {
        "mechastorm/laravel-lang-google-spreadsheet-importer": "1.*"
    }
}

1. 添加到服务提供者

安装完包后，您需要将其添加到 app/config/app.php 中的 providers。

示例

'providers' => array(
    'Mechastorm\LaravelLangGoogleSpreadsheetImporter\LaravelLangGoogleSpreadsheetImporterServiceProvider',
),

然后通过运行 php artisan list 来确认 artisan 命令是否存在，并检查输出中是否有 google-spreadsheet:generate-lang 命令。

2. 发布配置并配置

建议发布包的配置。

php artisan config:publish mechastorm/laravel-lang-google-spreadsheet-importer

您应该打开 app/config/packages/mechastorm/laravel-lang-google-spreadsheet-importer/config.php 并添加有关您的电子表格和 Google API 访问的详细信息。有关如何添加这些配置的详细信息，请参阅此主要 readme，特别是有关获取 Google API 凭据的信息。

强烈建议针对每个环境进行单独配置。

使用方法

假设您已正确安装和配置，则可以运行 artisan 命令来生成语言文件

php artisan google-spreadsheet:generate-lang

或使用环境变量

php artisan google-spreadsheet:generate-lang --env={env_name}

测试

即将推出！

贡献者

• Shih Oon Liong (@mechastorm)

许可证

在 Apache 2.0 许可证 下发布。