Moodle plugin which adds a PHP APCu management GUI to Moodle site administration.
This plugin requires Moodle 4.3+
For performance reasons, Moodle should always be run with a Caching backend. APCu is such a caching backend which is directly available in the PHP runtime. Unfortunately, APCu is kind of a black box and doesn't provide a management interface by default.
Luckily, the APCu developers provide a single-file APCu management GUIs within their codebase (https://github.com/krakjoe/apcu/). As a Moodle server administrator, you can just throw the apc.php file somewhere onto your Moodle server and get a APCu management GUI instantly. However, this approach requires that you protect the APCu management GUI from unauthorized access manually in your webserver and comes with the downside that the APCu management GUI is located outside Moodle.
For these reasons, we provide a wrapper to the APCu management GUI as a very simple Moodle admin tool providing it within Moodle site administration for Moodle administrators only.
Install the plugin like any other plugin to folder /admin/tool/apcu
See http://docs.moodle.org/en/Installing_plugins for details on installing Moodle plugins
This plugin wraps the APCu management GUI which was built by the APCu developers. This APCu management GUI is just a small PHP file. Unfortunately, this file can't be shipped together with this plugin's code as its PHP license is incompatible with Moodle's GPL license.
During installation, the plugin tries to download and store the APCu management GUI file to your wwwroot automatically. If this mechanism fails, especially because of the lack of permissions, you have to download the APCu management GUI file manually and store it to your webserver. Until you download and store this file, the plugin will not work.
The APCu management GUI is to be downloaded from: https://raw.githubusercontent.com/krakjoe/apcu/master/apc.php
The APCu management GUI is to be stored to: /tool/apcu/lib/apcu-gui/apcu.php.inc
After installing the plugin and storing the APCi management GUI file, it is active and fully working.
To use the plugin, please visit: Site administration -> Server -> APCu management.
The APCu management GUI should be self-explanatory for experienced PHP administrators.
This plugin does not add any additional capabilities.
This plugin works in a really simple way. It adds an admin tool page to Moodle's site administration tree and restricts access to this admin tool page to Moodle administrators (and other users having the moodle/site:config capability). The APCu management GUI is just included on the admin tool page.
The APCu management GUI file is stored as a library to this Moodle plugin and is renamed to /lib/apcu-gui/apcu.php.inc.
There is a potential for sensitive data leak, not personal data but data about the webserver's PHP configuration, if your webserver is configured to interpret *.inc files as PHP. An anonymous user could then visit the library's index page directly via https://yourmoodle.com/admin/tool/apcu/lib/apcu-gui/apcu.php.inc and would see the APCu management GUI circumventing Moodle's access control.
Please make sure that your webserver does not interpret *.inc files as PHP (which should be the default) or take any other measure that this file can not be accessed directly by a browser.
This plugin is developed and tested on Moodle Core's Boost theme. It should also work with Boost child themes, including Moodle Core's Classic theme. However, we can't support any other theme than Boost.
This plugin is published and regularly updated in the Moodle plugins repository: http://moodle.org/plugins/view/tool_apcu
The latest development version can be found on Github: https://github.com/moodle-an-hochschulen/moodle-tool_apcu
This plugin is carefully developed and thoroughly tested, but bugs and problems can always appear.
Please report bugs and problems on Github: https://github.com/moodle-an-hochschulen/moodle-tool_apcu/issues
We will do our best to solve your problems, but please note that due to limited resources we can't always provide per-case support.
Due to limited resources, the functionality of this plugin is primarily implemented for our own local needs and published as-is to the community. We are aware that members of the community will have other needs and would love to see them solved by this plugin.
Please issue feature proposals on Github: https://github.com/moodle-an-hochschulen/moodle-tool_apcu/issues
Please create pull requests on Github: https://github.com/moodle-an-hochschulen/moodle-tool_apcu/pulls
We are always interested to read about your feature proposals or even get a pull request from you, but please accept that we can handle your issues only as feature proposals and not as feature requests.
Due to limited resources, this plugin is only maintained for the most recent major release of Moodle as well as the most recent LTS release of Moodle. Bugfixes are backported to the LTS release. However, new features and improvements are not necessarily backported to the LTS release.
Apart from these maintained releases, previous versions of this plugin which work in legacy major releases of Moodle are still available as-is without any further updates in the Moodle Plugins repository.
There may be several weeks after a new major release of Moodle has been published until we can do a compatibility check and fix problems if necessary. If you encounter problems with a new major release of Moodle - or can confirm that this plugin still works with a new major release - please let us know on Github.
If you are running a legacy version of Moodle, but want or need to run the latest version of this plugin, you can get the latest version of the plugin, remove the line starting with $plugin->requires from version.php and use this latest plugin version then on your legacy Moodle. However, please note that you will run this setup completely at your own risk. We can't support this approach in any way and there is an undeniable risk for erratic behavior.
This Moodle plugin is shipped with an english language pack only. All translations into other languages must be managed through AMOS (https://lang.moodle.org) by what they will become part of Moodle's official language pack.
As the plugin creator, we manage the translation into german for our own local needs on AMOS. Please contribute your translation into all other languages in AMOS where they will be reviewed by the official language pack maintainers for Moodle.
This plugin has not been tested with Moodle's support for right-to-left (RTL) languages. If you want to use this plugin with a RTL language and it doesn't work as-is, you are free to send us a pull request on Github with modifications.
The plugin is maintained by
Moodle an Hochschulen e.V.
The copyright of this plugin is held by
Moodle an Hochschulen e.V.
Individual copyrights of individual developers are tracked in PHPDoc comments and Git commits.
This plugin was initially built, maintained and published by
Ulm University
Communication and Information Centre (kiz)
Alexander Bias
It was contributed to the Moodle an Hochschulen e.V. plugin catalogue in 2022.
This Moodle plugin is only a simple wrapper for the APCu management GUI by Ralf Becker, Rasmus Lerdorf and Ilia Alshanetsky.
These three own all copyrights for the APCu management GUI and maintain this tool on https://github.com/krakjoe/apcu/blob/master/apc.php.
This product includes PHP software, freely available from http://www.php.net/software/.