remi/rpminfo

RPM information

Installs: 1

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 5

Forks: 3

Open Issues: 0

Language:C

Type:php-ext

v1.1.1-p1 2024-10-07 10:52 UTC

This package is auto-updated.

Last update: 2024-10-28 22:39:55 UTC


README

Retrieve RPM information from PHP code using librpm.

This extension can be considered as stable, and be used on production environement.

Sources

Build

You need the rpm development files (rpm-devel) version >= 4.13.

From the sources tree

$ phpize
$ ./configure --enable-rpminfo
$ make
$ make test

From https://pecl.php.net/ using pecl command

$ pecl install rpminfo

From https://packagist.org/ using PHP Installer for Extensions

$ pie install remi/rpminfo

Usage

rpmvercmp

int rpmvercmp(string evr1, string evr2);

Allow to compare 2 EVR (epoch:version-release) strings. The return value is < 0 if evr1 < evr2, > 0 if evr1 > evr2, 0 if equal.

$ php -a
php > var_dump(rpmvercmp("1.0", "1.1"));
int(-1)
php > var_dump(rpmvercmp("1:1.0", "1.1"));
int(1)

rpminfo

array rpminfo(string path [, bool full  [, string &error]]);

Retrieve information from a rpm file, reading its metadata. If given error will be used to store error message instead of raising a warning. The return value is a hash table, or false if it fails.

$ php -a
php > print_r(rpminfo("tests/bidon.rpm"));
Array
(
    [Name] => bidon
    [Version] => 1
    [Release] => 1.fc25.remi
    [Arch] => x86_64
)

php > print_r(rpminfo("tests/bidon.rpm", true));
Array
(
    [Headeri18ntable] => C
    [Sigsize] => 2304
    [Sigmd5] => 644819c3566819b1e10a5c97943de094
    [Sha1header] => 0a86742fe53973ac9ab4611187a83ffb44f1de5a
    [Sha256header] => 9aab7242a80212ad1fe4fdd3b250c0c4f176c0b3fb1355c0d62ff094fc3f7da0
    [Name] => bidon
    [Version] => 1
    [Release] => 1.fc25.remi
    [Summary] => Bidon
    [Description] => A dummy package
    ...
    [IsSource] => 
)

php > var_dump(rpminfo("missing.rpm"));
Warning: rpminfo(): Can't open 'missing.rpm': No such file or directory in php shell code on line 1
bool(false)

php > var_dump(rpminfo("missing.rpm", false, $error));
bool(false)
php > echo $error;
Can't open 'missing.rpm': No such file or directory

rpmdbinfo

array rpmdbinfo(string path [, bool full ]);

Retrieve information from rpm database about an installed package. The return value is an array of hash tables, or false if it fails.

$ php -a
php > print_r(rpmdbinfo("php"));
Array
(
    [0] => Array
        (
            [Name] => php
            [Version] => 7.3.5
            [Release] => 1.fc31.remi
            [Summary] => PHP scripting language for creating dynamic web sites
            [Arch] => x86_64
        )
)

Retrieve information from rpm database about installed packages using glob or regex. The return value is an array of hash tables, or false if it fails.

$ php -a
php > print_r(rpmdbsearch("php-pecl-r*", RPMTAG_NAME, RPMMIRE_GLOB));
Array
(
    [0] => Array
        (
            [Name] => php-pecl-radius
            [Version] => 1.4.0
            [Release] => 0.10.b1.fc31
            [Summary] => Radius client library
            [Arch] => x86_64
        )
    [1] => Array
        (
            [Name] => php-pecl-redis5
            [Version] => 5.2.0
            [Release] => 1.fc31.remi.7.3
            [Summary] => Extension for communicating with the Redis key-value store
            [Arch] => x86_64
        )
    [2] => Array
        (
            [Name] => php-pecl-rpminfo
            [Version] => 0.2.3
            [Release] => 1.fc31.remi.7.3
            [Summary] => RPM information
            [Arch] => x86_64
        )
)

$ php -a
php > print_r(rpmdbsearch("^php-pecl-r", RPMTAG_NAME, RPMMIRE_REGEX));
Array
(
    [0] => Array
        (
            [Name] => php-pecl-radius
            [Version] => 1.4.0
            [Release] => 0.10.b1.fc31
            [Summary] => Radius client library
            [Arch] => x86_64
        )
    [1] => Array
        (
            [Name] => php-pecl-redis5
            [Version] => 5.2.0
            [Release] => 1.fc31.remi.7.3
            [Summary] => Extension for communicating with the Redis key-value store
            [Arch] => x86_64
        )
    [2] => Array
        (
            [Name] => php-pecl-rpminfo
            [Version] => 0.2.3
            [Release] => 1.fc31.remi.7.3
            [Summary] => RPM information
            [Arch] => x86_64
        )
)

$ php -a
php > print_r(rpmdbsearch(PHP_BINARY, RPMTAG_INSTFILENAMES));
Array
(
    [0] => Array
        (
            [Name] => php-cli
            [Version] => 7.3.15
            [Release] => 1.fc31.remi
            [Summary] => Command-line interface for PHP
            [Arch] => x86_64
        )
)

LICENSE

Author: Remi Collet

This extension is licensed under The PHP License, version 3.01

History

Created as a PoC, for fun, see history on https://blog.remirepo.net/post/2018/01/26/About-repomanage-performance-regression