Subversion Repositories ALCASAR

Rev

Rev 2770 | Rev 3037 | Go to most recent revision | 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))
5
* Copyright (c), 1999-2009, Michael Cramer ([sf.net/users/bigmichi1](https://sf.net/users/bigmichi1))
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))
2976 rexy 8
* Copyright (c), 2009-2021, 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
32
- Darwin / Mac OS / OS X
33
- Windows 2000 / XP / 2003 / Vista / 2008 / 7 / 2011 / 2012 / 8 / 8.1 / 10 / 2016 / 2019
34
- Android
35
 
36
#### Platforms currently in progress:
37
- Haiku
38
- Minix
39
- SunOS
40
- ReactOS
41
- IBM AIX
42
- QNX
43
 
44
If your platform is not here try checking out the mailing list archives or
45
the message boards on SourceForge.
46
 
47
INSTALLATION AND CONFIGURATION
48
------------------------------
49
 
50
#### Typical installation
51
 
52
Just decompress and untar the source (which you should have done by now,
53
if you're reading this...), into your webserver's document root.
54
 
55
There is a configuration file called phpsysinfo.ini.new. If this a brand new
56
installation, you should copy this file to phpsysinfo.ini and edit it.
57
 
58
- make sure your `php.ini` file's `include_path` entry contains "."
59
- make sure your `php.ini` has `safe_mode` set to 'off'.
60
 
61
phpSysInfo require php-xml extension.
62
 
63
Please keep in the mind that because phpSysInfo requires access to many
64
files in `/proc` and other system binary you **MUST DISABLE** `php's safe_mode`.
65
Please see the PHP documentation for information on how you
66
can do this.
67
 
68
That's it.  Restart your webserver (if you changed php.ini), and voila.
69
 
70
#### Docker container installation
71
 
72
- `sudo docker build -t phpsysinfo github.com/phpsysinfo/phpsysinfo`
73
- `sudo docker run -i -p 8080:80 -t phpsysinfo`
74
- go to http://localhost:8080/phpsysinfo/
75
 
76
KNOWN PROBLEMS
77
--------------
78
 
79
- phpSysInfo is not compatible with SELinux Systems
80
- small bug under FreeBSD with memory reporting
81
 
82
PLATFORM SPECIFIC ISSUES
83
------------------------
84
 
85
#### Windows with IIS
86
  On Windows systems we get our informations through the WMI interface.
87
  If you run phpSysInfo on the IIS webserver, phpSysInfo will not connect
88
  to the WMI interface for security reasons. At this point you MUST set
89
  an authentication mechanism for the directory in the IIS admin
90
  interface for the directory where phpSysInfo is installed. Then you
91
  will be asked for an user and a password when opening the page. At this
92
  point it is necessary to log in with an user that will be able to
93
  connect to the WMI interface. If you use the wrong user and/or password
94
  you might get an "ACCESS DENIED ERROR".
95
 
96
SENSOR RELATED INFORMATION
97
---------------------------
98
 
99
#### MBM5
100
  Make sure you set MBM5 Interval Logging to csv and to the data
101
  directory of phpSysInfo. The file must be called MBM5. Also make sure
102
  MBM5 doesn't add symbols to the values. This is a Quick MBM5 log parser,
103
  need more csv logs to make it better.
104
 
105
WHAT TO DO IF IT DOESN'T WORK
106
-----------------------------
107
 
108
First make sure you've read this file completely, especially the
109
"INSTALLATION AND CONFIGURATION" section.  If it still doesn't work then
110
you can:
111
 
112
Ask for help or submit a bug on Github (https://github.com/phpsysinfo/phpsysinfo/issues)
113
 
114
***!! If you have any problems, please set `DEBUG` to true in `phpsysinfo.ini`
115
and include any error messages in your bug report / help request !!***
116
 
117
OTHER NOTES
118
-----------
119
 
120
If you have a great idea or want to help out, just create a pull request with your change proposal
121
in the [phpSysInfo](https://github.com/phpsysinfo/phpsysinfo) repository.
122
 
123
LICENSING
124
---------
125
 
126
This program is released under the GNU Public License Version 2 or 
127
(at your option) any later version, see [COPYING](COPYING) for details.