dcentrica/metaport-agent-php

1.0.0-alpha5 2024-09-01 08:49 UTC

README

Pipeline Status Latest Release PHP phpstan Software License Test Coverage Docs

What is this?

A client library which connects any PHP app to a Metaport server using the CycloneDX SBOM standard for data interchange.

How to use

Introduction

The library will automatically generate an SBOM for your app, submit it to Metaport and subsequently delete it. Data can be sent using the HTTP or Email transports. See the docs site for example requests.

The library provides a single executable metaport which is automatically installed into Composer's vendor/bin directory. It's designed to be invoked on a schedule via cron from within an application's production environment or as part of a CI/CD pipeline.

Requirements

This package requires PHP ^8. If used as part of a CI/CD setup, it can be installed as a throwaway dependency via Composer's require-dev argument or as a permanent dependency of your PHP application.

Install

  1. Composer

In "disposable" CI pipelines and jobs:

composer require-dev dcentrica/metaport-agent-php

As part of production apps:

composer require dcentrica/metaport-agent-php
  1. Environment Variables

There are some environment variables which need to be set before the lib will operate correctly. Please see the docs site for more detailed installation and configuration instructions and examples.

Supported Frameworks and CMS's

Yours not listed? Contributions are very welcome. Please file an issue and issue a Merge Request, it's a one-line file change!