PHP Alternative Rename Function for Pantheon Hosting

If your PHP script is running on Pantheon hosting , you might be noticed that PHP rename function is not working. In PHP rename function is used to rename a file or directory and to move any file or directory.

PHP rename function fails on Pantheon Hosting

Pantheon server is configured in such way where os command mv is not available. Files and directories on Pantheon’s file serving infrastructure cannot be moved or renamed. Read about this problem on Pantheon’s doc


To rename or move a file/directory Pantheon suggest to copy file to new location/name and delete old one.

I have written a PHP class Custom_FS_Functions including a custom rename method. Download the class from GitHub

How to use this class and rename function

Create custom PHP function my_custom_rename that will call the rename method from Custom_FS_Functions class. Use this method only when your script is running on Pantheon hosting.

Example code

require_once "class-custom-fs-functions.php";

function my_custom_rename( $oldname, $newname ){
	$success = rename( $oldname, $newname );
	if( !$success )
		Custom_FS_Functions::rename( $oldname, $newname );

//use rename function
my_custom_rename( $file_or_dir_path , $new_file_or_dir_path );

Leave a Reply

Your email address will not be published. Required fields are marked *


This site uses Akismet to reduce spam. Learn how your comment data is processed.