drupol / phposinfo
Try to guess the host operating system.
Fund package maintenance!
drupol
Installs: 856 857
Dependents: 7
Suggesters: 0
Security: 0
Stars: 6
Watchers: 1
Forks: 1
Open Issues: 0
Requires
- php: >= 7.1.3
Requires (Dev)
- drupol/php-conventions: ^1.7.1
- friends-of-phpspec/phpspec-code-coverage: ^4.3.2
- infection/infection: ^0.13.6 || ^0.15.0
- phpspec/phpspec: ^5.1.2 || ^6.1.1
This package is auto-updated.
Last update: 2021-01-19 21:35:27 UTC
README
PHP OS Info
Description
Get information of the current operating system where PHP is running on.
Information that you can retrieve are:
- Operating system name
- Operating system family
- Machine UUID
There are many packages that does that already, but most of them are based on
the use of the variable PHP_OS
that contains the operating system name PHP was
built on, from php.net:
The operating system PHP was built for.
However, PHP_OS
might be sometimes not very accurate, then using
php_uname() might be a better fit for detecting the
operating system, we only use it as a fallback.
This library uses php_uname() and a static list of existing operating systems, and then from there, tries to deduct the operating system family.
From PHP 7.2, the variable PHP_OS_FAMILY
was added and based on the definition
from php.net:
The operating system family PHP was built for.
Either of 'Windows', 'BSD', 'Darwin', 'Solaris', 'Linux' or 'Unknown'.
So once again, if you're using a PHP which is cross compiled, using those constant is a bad idea.
Requirements
- PHP >= 7.1.3
Installation
composer require drupol/phposinfo
Usage
<?php include 'vendor/autoload.php'; use drupol\phposinfo\OsInfo; use drupol\phposinfo\Enum\Family; use drupol\phposinfo\Enum\Os; // Register constants if they do not exists: // * PHP_OS_FAMILY // * PHP_OS // * PHPOSINFO_OS_FAMILY // * PHPOSINFO_OS OsInfo::register(); // Get the OS name. OsInfo::os(); // Get the OS family. OsInfo::family(); // Check if the OS is Unix based. OsInfo::isUnix(); // Check if the OS is Apple based. OsInfo::isApple(); // Check if the OS is Windows based. OsInfo::isWindows(); // Check the OS version. OsInfo::version(); // Check the OS release. OsInfo::release(); // Check if the OS Family is Family::UNIX_ON_WINDOWS. OsInfo::isFamily(Family::UNIX_ON_WINDOWS); // Check if the OS is Os::FREEBSD. OsInfo::isOs(Os::FREEBSD); // Check if the OS is Windows. OsInfo::isOs('windows'); // Check if the OS family is darwin. OsInfo::isFamily('darwin'); // Get the machine UUID. OsInfo::uuid();
Code quality, tests and benchmarks
Every time changes are introduced into the library, Github actions are setup to test the library against different operating systems and PHP versions.
The library has tests written with PHPSpec.
Feel free to check them out in the spec
directory. Run composer phpspec
to trigger the tests.
Before each commit some inspections are executed with GrumPHP, run ./vendor/bin/grumphp run
to check manually.
PHPInfection is used to ensure that your code is properly tested, run composer infection
to test your code.
Contributing
Feel free to contribute to this library by sending Github pull requests. I'm quite reactive :-)