A system component which gives you access to server information.
Require this package with composer using the following command:
$ composer require plinker/systemCreating a client instance is done as follows:
<?php
require 'vendor/autoload.php';
/**
* Initialize plinker client.
*
* @param string $server - URL to server listener.
* @param string $config - server secret, and/or a additional component data
*/
$client = new \Plinker\Core\Client(
'http://example.com/server.php',
[
'secret' => 'a secret password'
]
);
// or using global function
$client = plinker_client('http://example.com/server.php', 'a secret password');
Once setup, you call the class though its namespace to its method.
The enumerate method is used to call multiple methods in a single call to reduce RPC requests.
| Parameter | Type | Description | Default |
|---|---|---|---|
| methods | string | array | A string or an array of methods |
| params | array | An array of params | [] |
The method could be used to call a single method, or multiple with parameters.
Call
$client->system->enumerate([
'arch',
'hostname',
'disks' => ['/'],
'ping' => ['https://google.com'],
]);
// or single method$client->system->enumerate('disks', ['/']);Response
Array
(
[arch] => x86_64
[hostname] => plinker
[disks] => Array
(
[0] => Array
(
[Filesystem] => /dev/sdb1
[Type] => ext4
[Size] => 95G
[Used] => 85G
[Avail] => 5.2G
[Used (%)] => 95%
[Mounted] => /
)
)
[ping] => -1
)
Returns the system architecture.
Call
$client->system->arch();Response
x86_64
Clear swap space, requires root, so should be used with task.
Call
$client->system->clear_swap();Response
Returns information about the CPU.
| Parameter | Type | Description | Default |
|---|---|---|---|
| parse | bool | Parse output into an array | true |
Call
$client->system->cpu_info();Response
Array
(
[Architecture] => x86_64
[CPU op-mode(s)] => 32-bit, 64-bit
[Byte Order] => Little Endian
[CPU(s)] => 2
[On-line CPU(s) list] => 0,1
[Thread(s) per core] => 1
[Core(s) per socket] => 2
[Socket(s)] => 1
[NUMA node(s)] => 1
[Vendor ID] => AuthenticAMD
[CPU family] => 16
[Model] => 4
[Model name] => AMD Phenom(tm) II X2 555 Processor
[Stepping] => 3
[CPU MHz] => 3200.000
[CPU max MHz] => 3200.0000
[CPU min MHz] => 800.0000
[BogoMIPS] => 6429.27
[Virtualization] => AMD-V
[L1d cache] => 64K
[L1i cache] => 64K
[L2 cache] => 512K
[L3 cache] => 6144K
[NUMA node0 CPU(s)] => 0,1
[Flags] => fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ht syscall nx mmxext fxsr_opt pdpe1gb rdtscp lm 3dnowext 3dnow constant_tsc rep_good nopl nonstop_tsc cpuid extd_apicid pni monitor cx16 popcnt lahf_lm cmp_legacy svm extapic cr8_legacy abm sse4a misalignsse 3dnowprefetch osvw ibs skinit wdt hw_pstate retpoline retpoline_amd rsb_ctxsw vmmcall npt lbrv svm_lock nrip_save
)
Returns disk space left in percentage.
| Parameter | Type | Description | Default |
|---|---|---|---|
| path | string | A directory of the filesystem or disk partition. | / |
Call
$client->system->disk_space();Response
71
Return mounted disks.
| Parameter | Type | Description | Default |
|---|---|---|---|
| parse | bool | Parse output into an array | true |
Call
$client->system->disks();
// dont parse$client->system->disks(false);Response
// Parsed
Array
(
[0] => Array
(
[Filesystem] => /dev/sdb1
[Type] => ext4
[Size] => 95G
[Used] => 85G
[Avail] => 5.2G
[Used (%)] => 95%
[Mounted] => /
)
)
// Unparsed
Filesystem Type Size Used Avail Use% Mounted on
/dev/sdb1 ext4 95G 85G 5.2G 95% /
Get system distro name.
Call
$client->system->distro();Response
UBUNTU
Drop memory caches, requires root, so should be used with task.
Call
$client->system->drop_cache();Response
true
Get the systems hostname.
Call
$client->system->hostname();Response
plinker
Get the systems load averages.
| Parameter | Type | Description | Default |
|---|---|---|---|
| parse | bool | Parse output into an array | true |
Call
$client->system->load();Response
Array
(
[1m] => 1.71
[5m] => 1.21
[15m] => 1.14
[curr_proc] => 3
[totl_proc] => 1437
[last_pid] => 3272
)
Returns an array of system logins.
Call
$client->system->logins();Response
Array
(
[0] => Array
(
[User] => root
[Terminal] => pts/1tmux(2972).%0
[Date] => Fri May 11 08:25
[Disconnected] => 11:01
[Duration] => 02:35
)
[1] => Array
(
[User] => root
[Terminal] => pts/1tmux(542).%0
[Date] => Thu May 10 15:01
[Disconnected] => 08:11
[Duration] => 17:09
)
[2] => Array
(
[User] => Reboot
[Terminal] => [Date] => [Disconnected] => [Duration] => )
[3] => Array
(
[User] => root
[Terminal] => pts/1tmux(5310).%0
[Date] => Thu May 10 07:42
[Disconnected] => crash
[Duration] => 07:19
)
)
... snip
)
Returns the machine-id for the system, generates one if does not have one.
Call
$client->system->machine_id();Response
82c887bcf6da43e5952fad9fd6ed15b6
Returns an array of memory stats for, used, cached and free in percentage values.
Call
$client->system->memory_stats();Response
Array
(
[used] => 15
[cache] => 0
[free] => 85
)
Get the total amount of memory in kB
Call
$client->system->memory_total();Response
16167888
Get network connections.
| Parameter | Type | Description | Default |
|---|---|---|---|
| parse | bool | Parse output into an array | true |
Call
$client->system->netstat();Response
Array
(
[0] => Array
(
[Proto] => tcp
[Recv-Q] => 0
[Send-Q] => 0
[Local Address] => 0.0.0.0:80
[Foreign Address] => 0.0.0.0:*
[State] => LISTEN
[PID/Program] => 1169/nginx:
[Process Name] => worker
)
... snip
)
Ping a hostname and return connection timing in milliseconds.
| Parameter | Type | Description | Default |
|---|---|---|---|
| host | string | Server hostname | |
| port | int | Service port, defaults to web | 80 |
Call
$client->system->ping('google.com');Response
31.18
Return system process tree
Call
$client->system->pstree();Response
systemd-+-Brackets-+-Brackets---Brackets---Brackets-+-{Chrome_ChildIOT}
| | |-2*[{CompositorTileW}]
| | |-{Compositor}
| | |-{HTMLParserThrea}
| | |-{Renderer::FILE}
| | |-{WorkerPool/203}
| | |-{WorkerPool/210}
| | |-{WorkerPool/212}
| | `-{WorkerPool/213}
| |-Brackets-node-+-5*[{Brackets-node}]
| | `-4*[{V8 WorkerThread}]
| |-{AudioThread}
| |-2*[{Brackets}]
| |-3*[{BrowserBlocking}]
| |-{CachePoolWorker}
| |-{Chrome_CacheThr}
| |-{Chrome_DBThread}
| |-{Chrome_DevTools}
| |-{Chrome_FileThre}
| |-{Chrome_FileUser}
| |-{Chrome_IOThread}
| |-{Chrome_ProcessL}
| |-{CompositorTileW}
| |-{IndexedDB}
| |-{NetworkChangeNo}
| |-{WorkerPool/1747}
| |-{gdbus}
| |-{gmain}
| |-{inotify_reader}
| |-{sandbox_ipc_thr}
| `-{threaded-ml}
|-LXDui-0.0.9-x86---{LXDui-0.0.9-x86}
... snip
Reboot the server, requires root, so should be used with task.
Call
$client->system->reboot();Response
true
Returns the current CPU usage in percentage value.
Call
$client->system->cpu_usage();Response
23
Check whether the system has updates.
Call
$client->system->system_updates();Response
1=has updates, 0=no updates, -1=unknown
Get top output as an array.
| Parameter | Type | Description | Default |
|---|---|---|---|
| parse | bool | Parse output into an array | true |
Call
$client->system->top();Response
Array
(
[0] => Array
(
[PID] => 27475
[USER] => user
[PR] => 20
[NI] => 0
[VIRT] => 1785692
[RES] => 671316
[SHR] => 140004
[S] => S
[%CPU] => 43.8
[%MEM] => 4.2
[TIME+] => 29:44.62
[COMMAND] => chrome
)
... snip
)
Get total disk space in bytes.
| Parameter | Type | Description | Default |
|---|---|---|---|
| path | string | A directory of the filesystem or disk partition. | / |
Call
$client->system->total_disk_space();Response
101369536512
Get system name/kernel version.
Call
$client->system->uname();Response
Linux 4.13.0-41-generic
Get system uptime string.
Call
$client->system->uptime();Response
up 1 day, 17 hours, 31 minutes
There are no tests setup for this component.
Please see CONTRIBUTING for details.
If you discover any security related issues, please contact me via https://cherone.co.uk instead of using the issue tracker.
If you use this project and make money from it or want to show your appreciation, please feel free to make a donation https://www.paypal.me/lcherone, thanks.
Get your company or name listed throughout the documentation and on each github repository, contact me at https://cherone.co.uk for further details.
The MIT License (MIT). Please see License File for more information.
See the organisations page for additional components.