PHP Uploads - Revision history

HansR: /* MaxConcurrentUploads */

2026-04-17T04:55:12Z

MaxConcurrentUploads

← Older revision		Revision as of 04:55, 17 April 2026
Line 84:		Line 84:

	==== MaxConcurrentUploads ====		==== MaxConcurrentUploads ====
	Just like you can in CMX, you may define the number of concurrent downloads which your server can handle. The parameter ''MaxConcurrentUploads'' defaults to no value which means it takes the value you defined in CMX. IIf you give this parameter a value, that value ~~overrules~~ the CMX value.		Just like you can in CMX, you may define the number of concurrent downloads which your server can handle. The parameter ''MaxConcurrentUploads'' defaults to no value which means it takes the value you defined in CMX. IIf you give this parameter a value, that value overrides the CMX value.

	==== delayMilliSeconds ====		==== delayMilliSeconds ====

HansR: /* CumulusUtils */

2026-04-16T19:43:56Z

CumulusUtils

← Older revision		Revision as of 19:43, 16 April 2026
Line 80:		Line 80:
	=== CumulusUtils ===		=== CumulusUtils ===
	The CUtils inifile parameter ''UploadDir'' specifies a subdirectory for CUtils relative to the webroot (the location of ''upload.php'') without any specification of the URL (as that is implicit in the use of ''upload.PHP'' as specified in ''Cumulus.ini''). If you wish all files to be transferred into the same directory as specified by CMX, then leave ''UploadDir'' empty.		The CUtils inifile parameter ''UploadDir'' specifies a subdirectory for CUtils relative to the webroot (the location of ''upload.php'') without any specification of the URL (as that is implicit in the use of ''upload.PHP'' as specified in ''Cumulus.ini''). If you wish all files to be transferred into the same directory as specified by CMX, then leave ''UploadDir'' empty.

			If you run ''CumulusUtils'' for ''[[Website Generator\|website]]'' without [[Thrifty - Cutils Command Qualifier\|Thrifty]] it may generate a lot of files which need to be uploaded. So many that your server may refuse uploads at a certain point. To avoid the uploads to fail CUtils has two optimisations for the PHP upload protocol:

			==== MaxConcurrentUploads ====
			Just like you can in CMX, you may define the number of concurrent downloads which your server can handle. The parameter ''MaxConcurrentUploads'' defaults to no value which means it takes the value you defined in CMX. IIf you give this parameter a value, that value overrules the CMX value.

			==== delayMilliSeconds ====
			Some servers have a limit to the number of HTTP Post requests can be handled (e.g. 10 per second). If that is the case you need to define a delay value for the time between uploads. This is defined with the
			''delayMilliSeconds'' parameter which defaults to 0 meaning the uploads secced each other as fast as possible.

	== Cumulus.ini ==		== Cumulus.ini ==

HansR: /* Disadvantages? */

2026-04-16T18:42:14Z

Disadvantages?

← Older revision		Revision as of 18:42, 16 April 2026
Line 39:		Line 39:
	== Disadvantages? ==		== Disadvantages? ==
	* It requires PHP support from your web provider - though most do		* It requires PHP support from your web provider - though most do
	:* Some web providers may not permit all the PHP methods that are required to implement this method		* Some web providers may not permit all the PHP methods that are required to implement this method
	* You need to change your upload paths to use the new method - make a copy of your ~~cumumulus~~.ini file so you can easily revert		* You need to change your upload paths to use the new method - make a copy of your Cumulus.ini and your cumulusutils.ini file so you can easily revert

	== Configuration ==		== Configuration ==

HansR: /* CumulusUtils */

2023-09-02T01:34:42Z

CumulusUtils

← Older revision		Revision as of 01:34, 2 September 2023
Line 79:		Line 79:

	=== CumulusUtils ===		=== CumulusUtils ===
	The CUtils inifile parameter ''UploadDir'' specifies a subdirectory for CUtils relative to the webroot (the location of ''upload.php'') without any specification of the URL (as that is implicit in the use of ''upload.PHP''). If you wish all files to be transferred into the same directory as specified by CMX, then leave ~~this parameter~~ empty.		The CUtils inifile parameter ''UploadDir'' specifies a subdirectory for CUtils relative to the webroot (the location of ''upload.php'') without any specification of the URL (as that is implicit in the use of ''upload.PHP'' as specified in ''Cumulus.ini''). If you wish all files to be transferred into the same directory as specified by CMX, then leave ''UploadDir'' empty.

	== Cumulus.ini ==		== Cumulus.ini ==

HansR: /* Configuration */

2023-09-02T01:22:09Z

Configuration

← Older revision		Revision as of 01:22, 2 September 2023
Line 77:		Line 77:

	This option should only be used if you are certain, you need it, and ideally you can restrict the PHP process file system permissions to the areas you want data written.		This option should only be used if you are certain, you need it, and ideally you can restrict the PHP process file system permissions to the areas you want data written.

			=== CumulusUtils ===
			The CUtils inifile parameter ''UploadDir'' specifies a subdirectory for CUtils relative to the webroot (the location of ''upload.php'') without any specification of the URL (as that is implicit in the use of ''upload.PHP''). If you wish all files to be transferred into the same directory as specified by CMX, then leave this parameter empty.

	== Cumulus.ini ==		== Cumulus.ini ==

Mcrossley at 11:49, 1 May 2023

2023-05-01T11:49:25Z

← Older revision		Revision as of 11:49, 1 May 2023
Line 9:		Line 9:
	It can transfer both text and binary files.		It can transfer both text and binary files.

	If the ''upload.php'' file is installed for CMX and the protocol works for CMX then it will also work for CUtils and the file locations will be relative to the location of the ''upload.php'' file (which therefore will be the root location of your website).		If the ''upload.php'' file is installed for CMX and the protocol works for CMX then it will also work for CUtils and the file locations will be relative to the location of the ''upload.php'' file (which therefore will be the root location of your website).

			'''Note''': It is not a requirement to change to using the PHP Upload method. The previous FTP/FTPS/SFTP methods remain fully supported and operational.

	== Is it secure? ==		== Is it secure? ==
Line 34:		Line 36:
	:* If any updates fail, then only the cumulative data since the last successful transfer is sent.		:* If any updates fail, then only the cumulative data since the last successful transfer is sent.
	:* It uses data compression over the network		:* It uses data compression over the network

			== Disadvantages? ==
			* It requires PHP support from your web provider - though most do
			:* Some web providers may not permit all the PHP methods that are required to implement this method
			* You need to change your upload paths to use the new method - make a copy of your cumumulus.ini file so you can easily revert

	== Configuration ==		== Configuration ==

PaulMy: /* Configuration */

2023-03-09T04:09:55Z

Configuration

← Older revision		Revision as of 04:09, 9 March 2023
Line 42:		Line 42:
	#Copy the '''/webfiles/upload.php''' to your web server, place it in the root folder of the default web site along with the index.html files etc		#Copy the '''/webfiles/upload.php''' to your web server, place it in the root folder of the default web site along with the index.html files etc
	#You will need to update the paths for the NOAA Reports (it probably needs to be just “Reports”)		#You will need to update the paths for the NOAA Reports (it probably needs to be just “Reports”)
	#Amend the paths of any Extra Files you upload (it probably needs to be just the file name)		#Amend the paths of any Extra Files you upload (it probably needs to be just the remote file name)
	#The uploads should start working!		#The uploads should start working!
	#You can now disable all the "Create local" options for files in Internet Settings\|Interval Settings. Local copies of the files created in the /web folder are no longer required		#You can now disable all the "Create local" options for files in Internet Settings\|Interval Settings. Local copies of the files created in the /web folder are no longer required

PaulMy: /* Configuration */

2023-03-09T04:09:06Z

Configuration

← Older revision		Revision as of 04:09, 9 March 2023
Line 42:		Line 42:
	#Copy the '''/webfiles/upload.php''' to your web server, place it in the root folder of the default web site along with the index.html files etc		#Copy the '''/webfiles/upload.php''' to your web server, place it in the root folder of the default web site along with the index.html files etc
	#You will need to update the paths for the NOAA Reports (it probably needs to be just “Reports”)		#You will need to update the paths for the NOAA Reports (it probably needs to be just “Reports”)
	#Amend the paths of any Extra Files you upload		#Amend the paths of any Extra Files you upload (it probably needs to be just the file name)
	#The uploads should start working!		#The uploads should start working!
	#You can now disable all the "Create local" options for files in Internet Settings\|Interval Settings. Local copies of the files created in the /web folder are no longer required		#You can now disable all the "Create local" options for files in Internet Settings\|Interval Settings. Local copies of the files created in the /web folder are no longer required

Mcrossley at 10:13, 8 March 2023

2023-03-08T10:13:42Z

@@ Line 1: / Line 1: @@
 == What is it? ==
-In February 2023 for Cumulus MX version 3.24.0 a new PHP upload mechanism was introduced as an alternative to using FTP, FTPS, or SFTP (FTP over SSH).
+In March 2023 for Cumulus MX version 3.24.0 a new PHP upload mechanism was introduced as an alternative to using FTP, FTPS, or SFTP (FTP over SSH).
 It uses the HTTPS or HTTP protocol for transferring file data. It requires that you have a PHP enabled web server (most are), and that you upload a small PHP file to the root folder of your web site.
@@ Line 69: / Line 69: @@
 Changing this to ''false'' means the script will be allowed to create files anywhere in server file system that the PHP process has write permissions.
-This option should only be used if you are certain you need it, and ideally can restrict the PHP process file system permissions to the areas you want data written.
+This option should only be used if you are certain, you need it, and ideally you can restrict the PHP process file system permissions to the areas you want data written.
 == Cumulus.ini ==
@@ Line 80: / Line 80: @@
 <pre>PHP-URL=<URL>
 PHP-Secret=<key as configured in CMX></pre>

Mcrossley: /* What are the advantages? */

2023-03-07T17:28:53Z

What are the advantages?

← Older revision		Revision as of 17:28, 7 March 2023
Line 32:		Line 32:
	* It reduces bandwidth.		* It reduces bandwidth.
	:* Unlike FTP which uploads the whole file each time, the PHP upload can send incremental data. For the default web site, most the data is the graph files and every update each entire file is sent over FTP every time just to add one new data point. Using the PHP upload, just that new data point is sent for each file, and the PHP script appends it to the existing file on your server.		:* Unlike FTP which uploads the whole file each time, the PHP upload can send incremental data. For the default web site, most the data is the graph files and every update each entire file is sent over FTP every time just to add one new data point. Using the PHP upload, just that new data point is sent for each file, and the PHP script appends it to the existing file on your server.
			:* If any updates fail, then only the cumulative data since the last successful transfer is sent.
	:* It uses data compression over the network		:* It uses data compression over the network