Skip to content

Commit a6b4f2a

Browse files
committed
docs: add note about special characters in paths
1 parent 053d669 commit a6b4f2a

2 files changed

Lines changed: 4 additions & 0 deletions

File tree

user_guide_src/source/installation/installing_composer.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,8 @@ The command above will create a "project-root" folder.
3939
If you omit the "project-root" argument, the command will create an
4040
"appstarter" folder, which can be renamed as appropriate.
4141

42+
.. note:: CodeIgniter autoloader does not allow special characters that are illegal in filenames on certain operating systems. Only allow characters deemed safe for POSIX portable filenames, plus the forward slash for directory separators. So if you install CodeIgniter under the folder that contains the special characters like ``(``, ``)``, etc., CodeIgniter won't work.
43+
4244
If you don't need or want phpunit installed, and all of its composer
4345
dependencies, then add the ``--no-dev`` option to the end of the above
4446
command line. That will result in only the framework, and the three

user_guide_src/source/installation/installing_manual.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Installation
2222
Download the `latest version <https://github.com/CodeIgniter4/framework/releases/latest>`_,
2323
and extract it to become your project root.
2424

25+
.. note:: CodeIgniter autoloader does not allow special characters that are illegal in filenames on certain operating systems. Only allow characters deemed safe for POSIX portable filenames, plus the forward slash for directory separators. So if you install CodeIgniter under the folder that contains the special characters like ``(``, ``)``, etc., CodeIgniter won't work.
26+
2527
Setting Up
2628
----------
2729

0 commit comments

Comments
 (0)