joomla/cve

Joomla CVE Package

3.0.0 2023-10-05 20:26 UTC

Requires

• php: ^8.1.0
• ext-json: *
• joomla/registry: ^3.0
• joomla/uri: ^3.0
• psr/http-client: ^1.0.1

Requires (Dev)

• joomla/http: ^3.0
• phan/phan: ^5.4.2
• phpstan/phpstan: ^1.10.7
• phpunit/phpunit: ^9.5.28
• roave/security-advisories: dev-master
• squizlabs/php_codesniffer: ^3.7.2
• yoast/phpunit-polyfills: ^1.0.4

GPL-2.0-or-later

• framework
• joomla
• cve

README

Requires PHP 7 >= 7.3 or PHP 8 < 8.2

Using the CVE Package

tbd

Instantiating CVE

Instantiating CVE Service is easy:

use Joomla\Cve\CveService;

$cve = new CveService;

This creates a basic Github object that can be used to access publicly available resources on mitre.org.

In most cases it is necessary to specify additional options. This can be done by injecting in a Registry object with your preferred options. Support is available for optionally providing a custom CVE account username and password, as well as a custom URL for the CVE API server (as would be the case for testing purposes).

use Joomla\Cve\CveService;
use Joomla\Registry\Registry;

$options = new Registry;
$options->set('api.org', 'cve_org');
$options->set('api.username', 'cve_username');
$options->set('api.key', 'cve_key');
$options->set('api.url', 'http://localhost:3000');

$cve = new CveService($options);

Available Options

Installation via Composer

Add "joomla/cve": "~2.0@dev" to the require block in your composer.json and then run composer install.

{
	"require": {
		"joomla/cve": "~2.0@dev"
	}
}

Alternatively, you can simply run the following from the command line:

composer require joomla/cve "~2.0@dev"

If you want to include the test sources, use

composer require --prefer-source joomla/cve "~2.0"