NetSuite PHP API 客户端使用教程

1. 项目介绍

NetSuite PHP API 客户端是一个PHP语言的库，用于访问NetSuite的API。它基于NetSuite官方的PHP Toolkit开发，进行了重构和优化，使其更适合现代PHP应用程序的开发。该客户端将NetSuite提供的近2000个类分散到单独的文件中，并支持通过composer安装和自动加载，方便开发者使用。

2. 项目快速启动

首先，确保您的环境中已经安装了composer。接着，通过以下命令将NetSuite PHP API客户端安装到您的项目中：

composer require ryanwinchester/netsuite-php

以下是一个快速启动的示例代码，演示如何使用token-based认证方式创建NetSuiteService类的实例：

require 'vendor/autoload.php';

use NetSuite\NetSuiteService;

$config = [
    // 必填配置
    "endpoint" => "2021_1",
    "host" => "https://webservices.netsuite.com",
    "account" => "MYACCT1",
    "consumerKey" => "0123456789ABCDEF",
    "consumerSecret" => "0123456789ABCDEF",
    "token" => "0123456789ABCDEF",
    "tokenSecret" => "0123456789ABCDEF",
    
    // 可选配置
    "signatureAlgorithm" => 'sha256', // 默认为'sha256'
    "logging" => true,
    "log_path" => "/var/www/myapp/logs/netsuite",
    "log_format" => "netsuite-php-%date-%operation",
    "log_dateformat" => "Ymd.His.u"
];

$service = new NetSuiteService($config);

您也可以选择将配置信息放入环境变量中，这在托管环境中非常有用。

3. 应用案例和最佳实践

日志记录

日志记录通常在配置级别进行设置。您还可以在运行时使用方法开启或关闭日志记录。如果不指定日志目录，将不会创建日志文件。

// 设置日志路径
$service->setLogPath('/path/to/logs');
// 开启日志记录
$service->logRequests(true);
// 关闭日志记录
$service->logRequests(false);

类文件生成

如果需要自己生成类文件，可以按照以下步骤操作：

1. 下载NetSuite PHP Toolkit。
2. 解压内容到项目的./original/目录下。
3. 运行./utilities/separate_classes.php或使用composer generate。

4. 典型生态项目

对于使用Laravel框架的项目，有一个名为netsuitephp/netsuite-laravel的生态项目，可以简化NetSuite客户端在Laravel应用中的集成过程。通过引入这个包，可以方便地在服务容器中创建和获取客户端实例。

以上就是NetSuite PHP API客户端的介绍和快速启动指南。在实际应用中，请根据具体需求调整配置和使用细节。