Download the PHP package datafoodconsortium/connector without Composer

Data Food Consortium Connector

The Data Food Consortium (DFC) Connector is a tool to help you to integrate the DFC standard within you application.

Each concept of the DFC ontology can be manipulated with the help of the corresponding class supplied by the connector.

This connector will also help you to import and export data so you can exchange information with other DFC standard compliant platforms.

The Data Food Consortium project (DFC) aims to provide interoperability between food supply chain platforms.

Get started

The API reference is available here.

Install

You can install the connector with composer:

Load the taxonomies

You can then load our different SKOS taxonomies providing the corresponding JSON-LD files:

These taxonomies are accessible directly from the connector, like:

Object creation

You can create objects by calling the new operator.

Remark: each newly created object will be saved into the store provided to the Connector. This store will allow you to access to the referenced objects more easily. You can disable this behavior passing the doNotStore: true parameter when constructing the objects.

Remark: Except for anonymous objects (blank nodes), the semanticId constructor parameter is mandatory. All the other parameters are optional.

Available concreate classes:

• Address
• AllergenCharacteristic
• Catalog
• CatalogItem
• CustomerCategory
• Enterprise
• NutrientCharacteristic
• Offer
• Order
• OrderLine
• Person
• PhysicalCharacteristic
• PlannedConsumptionFlow
• PlannedProductionFlow
• PlannedTransformation
• Price
• QuantitativeValue
• Quantity
• SaleSession
• SKOSConcept
• SuppliedProduct
• TechnicalProduct

Object accessors and mutators

Read object properties (accessor)

You can read the properties of an object using getter methods.

The previous method returned a simple string. But an object ofen contains other objects. In the semantic web, every object has its own URI (it is stored at an other location on the network). So we will store only a reference to these contained objects using their URI. They are called "referenced objects".

To access a referenced object using the connector there is nothing special to do:

Remark: Running the previous code sample will trigger a call to the fetch function of the connector. If the referenced object it is not already in the connector store, it will be downloaded from the network.

Change object properties (mutator)

If you want to change a property after the creation of the object, you can use its proper setter method like:

You can also add a value to properties that are array:

Export objects

With the Connector, you can export DFC object(s). The default exporter exports objects to JSON-LD:

This will output DFC compliant valid JSON-LD like:

Import objects

The DFC Connector provides method to import data. The default importer imports JSON-LD data.

To import objects from JSON-LD, use:

The default fetch function looks like:

You can pass a custom function via the Connector::setFetchFunction method.

Configure

You can adapt different components of the connector to your needs with the following connector methods:

See the Semantizer documentation for more details.

Examples

Planned transformation loop