islandora/chullo

A PHP client for interacting with a Fedora 4 server.

2.0.1 2023-06-30 14:00 UTC

README

Latest Stable Version Minimum PHP Version Downloads Build Status Contribution Guidelines LICENSE codecov

Introduction

Chullo is a PHP client for Fedora built using Guzzle and EasyRdf.

Requirements

This module requires the following modules/libraries:

Installation

  1. git clone git@github.com:Islandora/chullo.git
  2. cd chullo
  3. php composer.phar install

You can also install with composer by pointing to your local clone. Just add these relevant bits to your composer.json:

{
    "repositories": [
        {
            "type": "vcs",
            "url": "/path/to/chullo"
        }
    ],
    "require": {
        "islandora/chullo": "^1"
    }
}

Then just php composer.phar install as usual.

Usage

use Islandora\Chullo\Chullo;

// Instantiated with static factory
$chullo = FedoraApi::create('http://localhost:8080/fcrepo/rest');

// Create a new resource
$uri = $chullo->createResource(); // http://localhost:8080/fcrepo/rest/0b/0b/6c/68/0b0b6c68-30d8-410c-8a0e-154d0fd4ca20

// Parse resource as an EasyRdf Graph
$graph = $chullo->getGraph($uri);

// Set the resource's title
$graph->set($uri, 'dc:title', 'My Sweet Title');

// Save the graph to Fedora
$chullo->saveGraph($uri, $graph);

Documentation

Further documentation for this module is available on the Islandora 8 documentation site.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

Maintainers/Sponsors

Current maintainers:

Development

If you would like to contribute, please get involved by attending our weekly Tech Call. We love to hear from you!

If you would like to contribute code to the project, you need to be covered by an Islandora Foundation Contributor License Agreement or Corporate Contributor License Agreement. Please see the Contributors pages on Islandora.ca for more information. islandora-playbook to get started. If you want to pull down the submodules for development, don't forget to run git submodule update --init --recursive after cloning.

License

MIT