Note: You are currently viewing documentation for Moodle 2.9. Up-to-date documentation for the latest stable version of Moodle may be available here: Using slash arguments.

Using slash arguments: Difference between revisions

From MoodleDocs
No edit summary
(improving wording based on info learned in MDL-50182)
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Environment}}
{{Environment}}
==Enabling slash arguments==
The function ''slash arguments'' (using pathinfo or PATH_INFO) is required for [[SCORM activity|SCORM packages]] and multiple-file resources with relative links such as [[IMS content package|IMS content packages]] to work correctly.


The slasharguments setting is intended mostly for diagnostic purposes and we ''''''strongly recommend this setting should be always enabled'''.
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]]


If you disable this '''slasharguments''' setting, many Moodle features will not work properly, such as:
==Error when uploading a file==
* SCORM packages.
If you obtain a 'File not found' error when uploading a file, it indicates that slash arguments need to be enabled on your web server.
* 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.
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''.


Another very common problem reported on support forums about slasharguments:
Warning: Disabling the use of slash arguments will result in SCORM packages and multiple-file resources not working and slash arguments warnings being displayed!
* [[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]]


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:
==Slash arguments environment check==
* [[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:  
Note: '''The use of slash arguments will be required in future versions of Moodle.'''
* [[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.'''
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
* MDL-50416 - slasharguments check gives a warning on install], for versions 2.9 and 2.9.1
 
[[es:Usando slash arguments]]

Latest revision as of 10:22, 9 October 2015

Enabling slash arguments

The function slash arguments (using pathinfo or PATH_INFO) is required for SCORM packages and multiple-file resources with relative links such as IMS content packages to work correctly.

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 need to be enabled on your web server.

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 and multiple-file resources 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.

See also