Skip to content

Added a note about the usual cURL certificate problem #7492

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 3 commits into from
Closed

Added a note about the usual cURL certificate problem #7492

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2cb57f2
Added a note about the usual cURL certificate problem
javiereguiluz Feb 14, 2017
a8fb7ea
Minor reword
javiereguiluz Feb 14, 2017
eb3dc23
Minor fixes
javiereguiluz Feb 16, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions setup.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,28 @@ to meet those requirements.
If the installer doesn't work for you or doesn't output anything, make sure
that the PHP `Phar extension`_ is installed and enabled on your computer.

.. note::

If the SSL certificates are not properly installed in your system, you
may get this error:

cURL error 60: SSL certificate problem: unable to get local issuer certificate.

You can solve this issue as follows:

#. Download a file with the updated list of certificates from
https://curl.haxx.se/ca/cacert.pem
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could be rendered as a link

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes ... but this is the syntax to display links in RST:

link-cacert-pem

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As far as I understand this will only work as long as the URL detection doesn't break, won't it? Do we rely on this anywhere else in the docs?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes ... but this is a core built-in Sphinx feature, so it "can't" fail.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fair enough, let's keep it. :)

#. Move the downloaded ``cacert.pem`` file to some safe location in your system
#. Update your ``php.ini`` file and configure the path to that file:

.. code-block:: ini
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This and the following lines must be indented by three additional spaces to be part of the list item.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed!


; Linux and macOS systems
curl.cainfo = "/path/to/cacert.pem"

; Windows systems
curl.cainfo = "C:\path\to\cacert.pem"

Basing your Project on a Specific Symfony Version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down