|Version 6 (modified by moo, 8 years ago) (diff)|
- Introduction: Introduction to XCache
- FeatureList: Feature list
- Faq: Frequently asked questions
- INI Settings: XCache ini settings reference
- API: XCache API reference
- Testing: How XCache is being tested
- How to Report A Bug: How to report the bug in a helpful way
How to Install XCache Administration Page
XCache Administration Page (referenced as admin-page below) is an important web interface that you can monitor and operate your opcode cache, seeing how well(or bad) it goes.
Before you can use admin-page, XCache must be installed as either extension or zend_extension in php.
Generating your auth password
Admin-page is protected by http-auth, it is disabled if you haven't yet set a password. The user/pass of http-auth can be set in php.ini (see PhpIni). But you have to md5(your password) first.
setup a php page with webserver
<?php echo md5("password"); ?>
request it from browser and get 5f4dcc3b5aa765d61d8327deb882cf99. So update php.ini:
Example admin auth setting
xcache.admin.user = "mOo" xcache.admin.pass = "5f4dcc3b5aa765d61d8327deb882cf99"
This is an example only. Use your own password to get your own md5 string.
Setting up web interface
The fastest and simplest way to do so is copying your xcache/admin/ (the whole directory) to your web document-root or sub-directory of it.
Request it from your browser, a http-auth prompt will popup. Fill your user/pass in, and it's done.
If you're installing XCache with os distro package manager, rpm/apt-get/emerge etc, you might want to do a "alias" in webserver instead of copying the scripts, to stay admin-page up to date when the package is updated.
Lighttpd setting (for example only)
alias.url += ("/xcache-admin/" => "/usr/share/xcache/admin/")
Note: check open_basedir (if enabled) against /usr/share/xcache/
Restart php, and your webserver if needed, and check it out from your browser.
Customizing your config.php
WARNING: This is for advanced user only.
Copy config.php.example to config.php, read the inline comments. It should be simple if you have php programming skill.