loophp / phposinfo
Try to guess the host operating system.
Fund package maintenance!
drupol
Installs: 4 109 622
Dependents: 8
Suggesters: 0
Security: 0
Stars: 4
Watchers: 4
Forks: 0
Open Issues: 2
Requires
- php: ^8
Requires (Dev)
- ext-pcov: *
- drupol/php-conventions: ^5.0.0
- friends-of-phpspec/phpspec-code-coverage: ^6
- infection/infection: ^0.26
- infection/phpspec-adapter: ^0.2.0
- phpspec/phpspec: ^7
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 loophp/phposinfo
Usage
<?php include 'vendor/autoload.php'; use loophp\phposinfo\OsInfo; use loophp\phposinfo\Enum\Family; use loophp\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 by sending pull requests. We are a usually very responsive team and we will help you going through your pull request from the beginning to the end.
For some reasons, if you can't contribute to the code and willing to help, sponsoring is a good, sound and safe way to show us some gratitude for the hours we invested in this package.
Sponsor me on Github and/or any of the contributors.
Changelog
See CHANGELOG.md for a changelog based on git commits.
For more detailed changelogs, please check the release changelogs.