2770 |
rexy |
1 |
phpSysInfo
|
|
|
2 |
==============
|
|
|
3 |
|
|
|
4 |
* Copyright (c), 1999-2008, Uriah Welcome ([sf.net/users/precision](https://sf.net/users/precision))
|
3100 |
rexy |
5 |
* Copyright (c), 1999-2009, Michael Cramer ([github.com/bigmichi1](https://github.com/bigmichi1), [sf.net/users/bigmichi1](https://sf.net/users/bigmichi1))
|
2770 |
rexy |
6 |
* Copyright (c), 2007-2008, Audun Larsen ([sf.net/users/xqus](https://sf.net/users/xqus))
|
|
|
7 |
* Copyright (c), 2007-2015, Erkan Valentin ([github.com/rk4an](https://github.com/rk4an), [sf.net/users/jacky672](https://sf.net/users/jacky672))
|
3179 |
rexy |
8 |
* Copyright (c), 2009-2023, Mieczyslaw Nalewaj ([github.com/namiltd](https://github.com/namiltd), [sf.net/users/namiltd](https://sf.net/users/namiltd))
|
2770 |
rexy |
9 |
* Copyright (c), 2010-2012, Damien Roth ([sf.net/users/iysaak](https://sf.net/users/iysaak))
|
|
|
10 |
|
|
|
11 |
|
|
|
12 |
REQUIREMENTS
|
|
|
13 |
------------
|
|
|
14 |
|
|
|
15 |
PHP 5.1.3 or later with SimpleXML, PCRE, XML and DOM extension.
|
|
|
16 |
|
|
|
17 |
#### Suggested extensions:
|
|
|
18 |
- mbstring: Required for *nix non UTF-8 systems
|
|
|
19 |
- com_dotnet: Required for Windows environments
|
|
|
20 |
- xsl: Required for static mode
|
|
|
21 |
- json: Required for bootstrap mode
|
|
|
22 |
|
|
|
23 |
CURRENT TESTED PLATFORMS
|
|
|
24 |
------------------------
|
|
|
25 |
|
|
|
26 |
- Linux 2.6+
|
|
|
27 |
- FreeBSD 7+
|
|
|
28 |
- OpenBSD 2.8+
|
|
|
29 |
- NetBSD
|
|
|
30 |
- DragonFly
|
|
|
31 |
- HP-UX
|
3100 |
rexy |
32 |
- Darwin / Mac OS / OS X / iOS
|
3037 |
rexy |
33 |
- Windows 2000 / XP / 2003 / Vista / 2008 / 7 / 2011 / 2012 / 8 / 8.1 / 10 / 10 IoT / 2016 / 2019 / 2022 / 11
|
2770 |
rexy |
34 |
- Android
|
|
|
35 |
|
|
|
36 |
#### Platforms currently in progress:
|
|
|
37 |
- Haiku
|
|
|
38 |
- Minix
|
|
|
39 |
- SunOS
|
|
|
40 |
- ReactOS
|
|
|
41 |
- IBM AIX
|
|
|
42 |
- QNX
|
3100 |
rexy |
43 |
- GNU Hurd
|
|
|
44 |
- FortiOS (via SSH)
|
|
|
45 |
- DrayOS (via SSH)
|
2770 |
rexy |
46 |
|
|
|
47 |
If your platform is not here try checking out the mailing list archives or
|
3179 |
rexy |
48 |
the message boards on Github.
|
2770 |
rexy |
49 |
|
|
|
50 |
INSTALLATION AND CONFIGURATION
|
|
|
51 |
------------------------------
|
|
|
52 |
|
|
|
53 |
#### Typical installation
|
|
|
54 |
|
|
|
55 |
Just decompress and untar the source (which you should have done by now,
|
|
|
56 |
if you're reading this...), into your webserver's document root.
|
|
|
57 |
|
|
|
58 |
There is a configuration file called phpsysinfo.ini.new. If this a brand new
|
|
|
59 |
installation, you should copy this file to phpsysinfo.ini and edit it.
|
|
|
60 |
|
|
|
61 |
- make sure your `php.ini` file's `include_path` entry contains "."
|
|
|
62 |
- make sure your `php.ini` has `safe_mode` set to 'off'.
|
|
|
63 |
|
|
|
64 |
phpSysInfo require php-xml extension.
|
|
|
65 |
|
|
|
66 |
Please keep in the mind that because phpSysInfo requires access to many
|
|
|
67 |
files in `/proc` and other system binary you **MUST DISABLE** `php's safe_mode`.
|
|
|
68 |
Please see the PHP documentation for information on how you
|
|
|
69 |
can do this.
|
|
|
70 |
|
|
|
71 |
That's it. Restart your webserver (if you changed php.ini), and voila.
|
|
|
72 |
|
|
|
73 |
#### Docker container installation
|
|
|
74 |
|
3037 |
rexy |
75 |
- `sudo docker build -t phpsysinfo github.com/phpsysinfo/phpsysinfo#main`
|
2770 |
rexy |
76 |
- `sudo docker run -i -p 8080:80 -t phpsysinfo`
|
|
|
77 |
- go to http://localhost:8080/phpsysinfo/
|
|
|
78 |
|
|
|
79 |
KNOWN PROBLEMS
|
|
|
80 |
--------------
|
|
|
81 |
|
|
|
82 |
- phpSysInfo is not compatible with SELinux Systems
|
|
|
83 |
- small bug under FreeBSD with memory reporting
|
|
|
84 |
|
|
|
85 |
PLATFORM SPECIFIC ISSUES
|
|
|
86 |
------------------------
|
|
|
87 |
|
|
|
88 |
#### Windows with IIS
|
|
|
89 |
On Windows systems we get our informations through the WMI interface.
|
|
|
90 |
If you run phpSysInfo on the IIS webserver, phpSysInfo will not connect
|
|
|
91 |
to the WMI interface for security reasons. At this point you MUST set
|
|
|
92 |
an authentication mechanism for the directory in the IIS admin
|
|
|
93 |
interface for the directory where phpSysInfo is installed. Then you
|
|
|
94 |
will be asked for an user and a password when opening the page. At this
|
|
|
95 |
point it is necessary to log in with an user that will be able to
|
|
|
96 |
connect to the WMI interface. If you use the wrong user and/or password
|
|
|
97 |
you might get an "ACCESS DENIED ERROR".
|
|
|
98 |
|
|
|
99 |
SENSOR RELATED INFORMATION
|
|
|
100 |
---------------------------
|
|
|
101 |
|
|
|
102 |
#### MBM5
|
|
|
103 |
Make sure you set MBM5 Interval Logging to csv and to the data
|
|
|
104 |
directory of phpSysInfo. The file must be called MBM5. Also make sure
|
|
|
105 |
MBM5 doesn't add symbols to the values. This is a Quick MBM5 log parser,
|
|
|
106 |
need more csv logs to make it better.
|
|
|
107 |
|
|
|
108 |
WHAT TO DO IF IT DOESN'T WORK
|
|
|
109 |
-----------------------------
|
|
|
110 |
|
|
|
111 |
First make sure you've read this file completely, especially the
|
|
|
112 |
"INSTALLATION AND CONFIGURATION" section. If it still doesn't work then
|
|
|
113 |
you can:
|
|
|
114 |
|
|
|
115 |
Ask for help or submit a bug on Github (https://github.com/phpsysinfo/phpsysinfo/issues)
|
|
|
116 |
|
|
|
117 |
***!! If you have any problems, please set `DEBUG` to true in `phpsysinfo.ini`
|
|
|
118 |
and include any error messages in your bug report / help request !!***
|
|
|
119 |
|
|
|
120 |
OTHER NOTES
|
|
|
121 |
-----------
|
|
|
122 |
|
|
|
123 |
If you have a great idea or want to help out, just create a pull request with your change proposal
|
|
|
124 |
in the [phpSysInfo](https://github.com/phpsysinfo/phpsysinfo) repository.
|
|
|
125 |
|
|
|
126 |
LICENSING
|
|
|
127 |
---------
|
|
|
128 |
|
3179 |
rexy |
129 |
This program is released under the GNU Public License Version 2 or
|
2770 |
rexy |
130 |
(at your option) any later version, see [COPYING](COPYING) for details.
|