Additionally, the explanation of what the options actually *do* needs work.  Options are listed as if they were all equally typical / normal / necessary, when in fact some of them are quite esoteric, rarely if ever necessary.  

Just looking at the name of CURLOPT_FTPPORT, one might expect that it was an alternative way to specify the FTP port.  In the modern-since-1998 EPSV mode, there is only one FTP port that is explicitly given a number, so by that standard there is only one FTP port.  

Unfortunately, as an old and hoary protocol, there is technically no such thing as 'the' FTP port, because FTP supports all sorts of oddball modes.  In old-school PASV mode, and especially in old-bordering-on-ancient-school active mode where PORT is used, that modern assumption is no longer the case.  The PHP helpdocs ought to reflect that, in general, unless you are doing something weird, FTPPORT is not gonna be useful.  (Right now they are just a cut-n-paste of the cURL helpdocs... but with brain-o mistakes like POST-vs-PORT added in!  Better to document the common options in an easy-to-understand way, and refer to the official helpdocs on the official webpage ... or else, make sure the php helpdocs are an improvement rather than a detriment.)  

Here is an example where FTPPORT was required:  

  http://stackoverflow.com/questions/13914262/ftp-fails-to-transmit-data-in-passive-mode-libcurl

Here is a case where EPSV and PASV and a misconfigured FTP server demand some of the esoteric options be put into realworld use:  

  http://www.unixlore.net/articles/using-curl-for-ftp-over-ssl-file.html

This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.