Try to guess the host operating system.
This package is auto-updated.
Last update: 2023-09-04 13:07:23 UTC
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.
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
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.
- PHP >= 7.1.3
composer require loophp/phposinfo
<?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();
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
Before each commit some inspections are executed with
./vendor/bin/grumphp run to
PHPInfection is used to ensure that
your code is properly tested, run
composer infection to test your code.
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.
For more detailed changelogs, please check the release changelogs.