Larinfo provide system information for Laravel.
It wraps Linfo to show IP address information on the server and client side, server software versions, and hardware information.
- PHP version:
^8.2. - Laravel version:
^11.0.
It is recommended to enable com_dotnet extension to get more accurate information.
In your php.ini file, add this line, and make sure you have php_com_dotnet.dll in your PHP ext directory.
extension=com_dotnetTo install using Composer, just run this command below.
composer require matriphe/larinfo| Larinfo | Laravel | Composer Command |
|---|---|---|
| 2.2 | 5.0, 5.1, 5.2, 5.3, 5.4, 5.5, and 5.6 |
composer require matriphe/larinfo:2.2 |
| 3.0.0 | 5.7.*, 5.8.*, ^6.0, ^7.0, and ^8.0 |
composer require matriphe/larinfo:3.0.0 |
| 4.0.0 | ^9.0 |
composer require matriphe/larinfo:4.0.0 |
| 4.1.0 | ^10.0 |
composer require matriphe/larinfo:4.1.0 |
| latest (4.2.0) | ^11.0 |
composer require matriphe/larinfo |
To publish the config (optional) run this command below.
php artisan vendor:publishThen select the number that points to Matriphe\Larinfo\LarinfoServiceProvider provider.
The new config will be placed in config/larinfo.php.
IP address information is taken using ipinfo.io service. If you've registered and has access token, put your token in the config/services.php inside the ipinfo variable.
'ipinfo' => [
'token' => 'your_ipinfo_token',
]If you don't want to hit ipinfo.io rate limit, it is recommended to cache it using Laravel built-in cache.
To get all info, use facade Larinfo and call the getInfo() method. It will return this array example.
use Larinfo;
$larinfo = Larinfo::getInfo();The result of that command is shown below.
$larinfo = [
'host'=> [
'city'=> 'San Francisco',
'country'=> 'US',
'hostname'=> '',
'ip'=> '104.20.8.94',
'loc'=> '37.7697,-122.3933',
'org'=> 'AS13335 Cloudflare, Inc.',
'phone'=> '',
'postal'=> '94107',
'region'=> 'California',
'timezone' => 'America/Los_Angeles',
],
'client'=> [
'city'=> 'Bekasi',
'country'=> 'ID',
'hostname'=> '',
'ip'=> '180.252.202.108',
'loc'=> '-6.2349,106.9896',
'org'=> 'AS17974 PT Telekomunikasi Indonesia',
'phone'=> '',
'postal'=> '',
'region'=> ''
],
'server'=> [
'software'=> [
'os'=> 'MacOS',
'distro'=> 'MacOS 10.15.7',
'kernel'=> '19.6.0',
'arc'=> 'x86_64',
'webserver'=> 'nginx/1.19.8',
'php'=> '8.0.3'
],
'hardware'=> [
'cpu'=> 'Intel® Core™ i5-3210M CPU @ 2.50GHz',
'cpu_count'=> 4,
'model'=> 'Apple device',
'virtualization'=> '',
'ram'=> [
'total'=> 8589934592,
'free'=> 8578883584,
'human_total' => '8.0 GiB',
'human_free' => '15.0 MiB',
],
'swap'=> [
'total'=> 2147483648,
'free'=> 426246144,
'human_total' => '2.0 GiB',
'human_free' => '406.5 MiB',
],
'disk'=> [
'total'=> 2999590176768,
'free'=> 1879852326912,
'human_total' => '2.7 TiB',
'human_free' => '1.7 TiB',
]
],
'uptime'=> [
'uptime'=> '2 days, 12 hours, 13 minutes, 43 seconds',
'booted_at'=> '2021-04-02 15:27:54'
]
],
'database'=> [
'driver'=> 'MySQL',
'version'=> '8.0.22'
]
];Other method you can use are:
getHostIpinfoto get host IP info (Larinfo::getHostIpinfo())getClientIpinfoto get client IP info (Larinfo::getClientIpinfo())getServerInfoSoftwareto get server software info (Larinfo::getServerInfoSoftware())getServerInfoHardwareto get server hardware info (Larinfo::getServerInfoHardware())getUptimeto get server uptime (Larinfo::getUptime())getServerInfoto get server info (Larinfo::getServerInfo())getDatabaseInfoto get database info (Larinfo::getDatabaseInfo())
You also can check using larinfo artisan command, by running this command below.
php artisan larinfoThe example of the result is shown below.
Larinfo
=======
+--------------------+------------------------------------------+
| Application |
+--------------------+------------------------------------------+
| PHP version | 8.1.12 |
| Laravel version | 10.4.1 |
+--------------------+------------------------------------------+
| Database |
+--------------------+------------------------------------------+
| Engine | SQLite |
| Version | 3.40.0 |
+--------------------+------------------------------------------+
| Operating System |
+--------------------+------------------------------------------+
| Type | MacOS |
| Name | MacOS 13.2.1 |
| Architecture | arm64 |
| Kernel Version | 22.3.0 |
+--------------------+------------------------------------------+
| Uptime |
+--------------------+------------------------------------------+
| Uptime | 5 days, 13 hours, 38 minutes, 25 seconds |
| First Boot | 2023-03-19 22:36:46 |
+--------------------+------------------------------------------+
| Server |
+--------------------+------------------------------------------+
| IP Address | 79.224.166.123 |
| Private IP Address | |
| Hostname | p5fe9ab9c.dip0.t-ipconnect.de |
| Provider | AS3320 Deutsche Telekom AG |
| City | Berlin |
| Region | Berlin |
| Country | DE |
+--------------------+------------------------------------------+
| Timezone |
+--------------------+------------------------------------------+
| Application | UTC |
| Server Location | Europe/Berlin |
+--------------------+------------------------------------------+
| Hardware |
+--------------------+------------------------------------------+
| Model | Mac mini |
| CPU count | 8 |
| CPU | Apple M1 |
+--------------------+------------------------------------------+
| RAM |
+--------------------+------------------------------------------+
| Total | 16.0 GiB |
| Free | 54.0 MiB |
+--------------------+------------------------------------------+
| SWAP |
+--------------------+------------------------------------------+
| Total | 3.0 GiB |
| Free | 964.7 MiB |
+--------------------+------------------------------------------+
| Disk Space |
+--------------------+------------------------------------------+
| Total | 2.2 TiB |
| Free | 1.0 TiB |
+--------------------+------------------------------------------+
To run the unit tests, execute this following command.
vendor/bin/phpunit --group unitOn the GitHub Actions, the tests run on the respective operating system, which are ubuntu, macos, and windows when a pull request is made.
To run the tests on Ubuntu 20.04 LTS (Focal Fossa) and Ubuntu 22.04 LTS (Jammy Jellyfish), run this following command.
vendor/bin/phpunit --group ubuntuTo run the tests on macOS Monterey (12) and macOS Ventura (13), run this following command.
vendor/bin/phpunit --group macosTo run the tests on Windows Server 2019 and Windows Server 2022, run this following command.
vendor/bin/phpunit --group windowsPlease see License File for more information.