Subversion Repositories ALCASAR

Rev

Rev 3100 | Details | Compare with Previous | Last modification | View Log

Rev Author Line No. Line
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.