README

SharePoint OAuth App 客户端 是一个 PHP 库，它通过 SharePoint Online (2013) REST API 使用 OAuth2 进行身份验证，并易于与 列表、文件夹、项、文件 和 用户 进行交互。

该库旨在符合 PSR-1、PSR-2 和 PSR-4 标准。

要求

• PHP 5.4+
• Guzzle
• PHP-JWT
• Carbon

安装

composer require ssswang/sharepoint-oauth-app-client

基本用法示例

<?php

require 'vendor/autoload.php';

use WeAreArchitect\SharePoint\SPException;
use WeAreArchitect\SharePoint\SPList;
use WeAreArchitect\SharePoint\SPSite;

    //Get credential instuctions https://github.com/ssswang/sharepoint-oauth-app-client/blob/master/docs/Credentials.md
    try {
    $settings = [
        'site' => [
            'resource'  => '00000000-0000-ffff-0000-000000000000/example.sharepoint.com@09g7c3b0-f0d4-416d-39a7-09671ab91f64',
            'client_id' => '52848cad-bc13-4d69-a371-30deff17bb4d/example.com@09g7c3b0-f0d4-416d-39a7-09671ab91f64',
            'secret'    => 'YzcZQ7N4lTeK5COin/nmNRG5kkL35gAW1scrum5mXVgE=',
        ]
    ];

    // create a SharePoint Site instance
    $site = SPSite::create('https://example.sharepoint.com/sites/mySite/', $settings);

    // generate an Access Token (App-only Policy)
    $site->createSPAccessToken();
    $site->createSPFormDigest();
    
    $folder = SPFolder::getByRelativeUrl($site, 'IT API Test Library');

    $newFolder = SPFolder::create($folder, "2019/06", []);


    echo "Write to IT API Test Library...\n";
    $name = "test.pdf";

    $content = fopen(storage_path($name), 'r');

    $this->uploadFile($site, 'IT API Test Library/2019/06', $name, $content);
    
    
    // get all the Lists and respective Items 
    $lists = SPList::getAll($site, [
        'fetch' => true,
    ]);

    // iterate through each List
    foreach ($lists as $list) {
        var_dump($list);

        // iterate through each List Item
        foreach ($list as $item) {
            var_dump($item);
        }
    }

} catch (SPException $e) {
    // handle exceptions
}

类文档

• SPSite
• SPAccessToken
• SPFormDigest
• SPList
• SPItem
• SPFolder
• SPFile
• SPUser

SharePoint 凭据

请参阅如何在此处生成 SharePoint 凭据。

故障排除

检查常见的库问题及其解决方法 此处

SharePoint 文档

• 通过 REST 与列表和列表项交互
• 通过 REST 与文件夹和文件交互
• 文件和文件夹 REST API 参考信息

许可证

MIT 许可证 (MIT)。有关更多信息，请参阅 许可证文件。