Using slash arguments: Difference between revisions

Latest revision as of 09:29, 27 November 2019

About slash arguments

'Slash arguments' (using PATH_INFO) is required for SCORM packages and multiple-file resources to display correctly. If your web server doesn't support 'slash arguments' and you are unable to configure it, the setting can be disabled, though it will result in things not working.

Enabling slash arguments

Slash arguments must be enabled on your web server, as described in:

Error when uploading a file

If you obtain a 'File not found' error when uploading a file, it indicates that slash arguments are not enabled on your web server. Please try enabling it.

If your web server doesn't support slash arguments, its use in Moodle can be disabled by un-ticking the checkbox 'Use slash arguments' in Administration > Site administration > Server > HTTP.

Warning: Disabling the use of slash arguments will result in SCORM packages not working and slash arguments warnings being displayed!

Slash arguments environment check

Note: The use of slash arguments will be required in future versions of Moodle.

If your web server doesn't support slash arguments, you will in future need to change to a web server which does. (It will no longer be possible to disable the use of slash arguments.)

In the meantime, Administration > Site administration > Server > Environment reports if the slash argument setting needs to be checked i.e. if it is detected that 'Use slash arguments' is disabled in Administration > Site administration > Server > HTTP. Thus, the check is a warning of the future requirement.

@@ Line 1: / Line 1: @@
 {{Environment}}
+==About slash arguments==
-The slasharguments setting is intended mostly for diagnostic purposes and we ''''''strongly recommend this setting should be always enabled'''.
+'Slash arguments' (using PATH_INFO) is required for SCORM packages and multiple-file resources to display correctly. If your web server doesn't support 'slash arguments' and you are unable to configure it, the setting can be disabled, though it will result in things not working.
-If you disable this '''slasharguments''' setting, many Moodle features will not work properly, such as:
+==Enabling slash arguments==
-* SCORM packages.
-* Relative links in embedded pages.
-* Add-ons and plugins.
-* Images.
-If you disable slasharguments setting and embedded images start to be displayed it means that the server is not properly configured.
+Slash arguments must be enabled on your web server, as described in:
+* [[Internet Information Services#Slasharguments|IIS slasharguments]]
+* [[Apache#Slasharguments|Apache slasharguments]]
+* [[Nginx#Slasharguments|Nginx slasharguments]]
-Another very common problem reported on support forums about slasharguments:
+==Error when uploading a file==
-* [[SCORM_FAQ#slash_arguments_warning_when_I_add.2Fupdate_SCORM_objects_in_my_course|SCORM FAQ: slash arguments warning when I add/update SCORM objects in my course]]
+If you obtain a 'File not found' error when uploading a file, it indicates that slash arguments are not enabled on your web server. Please try enabling it.
-A common problem on Apache web server is the '''File not found''' error after uploading a file. For further instructions to fix this issue can be found here:
+If your web server doesn't support slash arguments, its use in Moodle can be disabled by un-ticking the checkbox 'Use slash arguments' in ''Administration > Site administration > Server > HTTP''.
-* [[Installation_FAQ#Uploaded_files_give_.22File_not_found.22|File not found error on uploaded files]]
-For further information about slasharguments configuration on web servers see:
+Warning: Disabling the use of slash arguments will result in SCORM packages not working and slash arguments warnings being displayed!
-* [[Internet Information Services#Slasharguments|IIS server configuration]]
-* [[Apache#Slasharguments|Apache slasharguments configuration]]
-* [[Nginx#Slasharguments|Nginx slasharguments configuration]]
-'''Please note that will not be possible to disable slasharguments settings on moodle 3.0, we recommend to check and configure slasharguments in your webserver.'''
+==Slash arguments environment check==
+Note: '''The use of slash arguments will be required in future versions of Moodle.'''
+If your web server doesn't support slash arguments, you will in future need to change to a web server which does. (It will no longer be possible to disable the use of slash arguments.)
+In the meantime, ''Administration > Site administration > Server > Environment'' reports if the slash argument setting needs to be checked i.e. if it is detected that 'Use slash arguments' is disabled in ''Administration > Site administration > Server > HTTP''. Thus, the check is a warning of the future requirement.
+==See also==
+* [https://moodle.org/mod/forum/discuss.php?d=278916 Requiring slasharguments in Moodle 2.9 - will anybody be seriously affected?] forum discussion
+* [https://tracker.moodle.org/browse/MDL-50416 <nowiki>[MDL-50416]</nowiki> slasharguments check gives a warning on install], for versions 2.9 and 2.9.1
+* [https://tracker.moodle.org/browse/MDL-51554 <nowiki>[MDL-51554]</nowiki> Broken file serving under Apache and PHP-FPM via mod_proxy_fcgi, when the filename is not only plain ASCII or w/ blank spaces], for versions below  2.8.9 and 2.9.3
+[[es:Usando slash arguments]]
+[[de:Verwendung von slash arguments]]
+[[pt-br:Usando argumentos com barra]]

Documentation