Backup_Status::catch_fatals() - Code Metrics - Inspection of "Utilise file locking so we can track crashed proce..." - humanmade/backupwordpress - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#1025)

by Tom

created 2016-08-28 17:25 UTC

Backup_Status::catch_fatals() B

↳ Parent: Backup_Status

Complexity

Conditions	6
Paths	4

Size

Total Lines	22
Code Lines	11

Duplication

Lines	3
Ratio	13.64 %

Importance

Changes	2
Bugs	0	Features	0

Metric	Value
cc	6
eloc	11
c	2
b	0
f	0
nc	4
nop	0
dl	3
loc	22
rs	8.6737

<?php

namespace HM\BackUpWordPress;

use Symfony\Component\Filesystem\LockHandler;

/**
 * Manages status and progress of a backup
 */
class Backup_Status {

	/**
	 * The filename for the backup file we are the tracking status of
	 *
	 * @var string
	 */
	private $filename = '';

	/**
	 * [$lock_handler description]
	 *
	 * @var LockHandler
	 */
	private $lock_handler = '';

	private $callback;

	/**
	 * @param string $id The unique id for the backup job
	 */
	public function __construct( $id ) {
		$this->id = (string) $id;
class MyClass { }

$x = new MyClass();
$x->foo = true;
		$this->cleanup_after_crash();
	}

	/**
	 * Start the tracking a backup process.
	 *
	 * This creates a backup running file and issues a file lock. This prevents duplicate
	 * instances of this backup process running concurrently and allows us to detect if
	 * the PHP thread running the process is killed as that will clear the lock.
	 *
	 * @param  string $backup_filename The filename for the backup file that we're tracking
	 * @param  string $status_message  The initial status for the backup process
	 *
	 * @return boolean                  Whether the backup process was success marked as started
	 */
	public function start( $backup_filename, $status_message ) {
		$this->filename = $backup_filename;

		// Clear any errors from previous backup runs
		Notices::get_instance()->clear_notice_context( 'backup_failed' );

		add_action( 'shutdown', array( $this, 'catch_fatals' ), 10 );

		$this->lock_handler = new LockHandler( basename( $this->get_status_filepath() ), Path::get_path() );

		if ( ! $this->lock_handler->lock() || $this->get_status() ) {
		    return false;
		}

		return $this->set_status( $status_message );
	}

	/**
	 * Mark a backup process as finished.
	 *
	 * This removes the file lock and deletes the running file.
	 */
	public function finish() {

		if ( isset( $this->lock_handler ) && is_a( $this->lock_handler, 'LockHandler' ) ) {
			$this->lock_handler->release();
		}

		// Delete the backup running file
		if ( file_exists( $this->get_status_filepath() ) ) {
			return unlink( $this->get_status_filepath() );
		}

		return false;
	}

	/**
	 * Check if the backup has been started by checking if the running file
	 * exists.
	 *
	 * @return boolean Whether the backup process has been started
	 */
	public function is_started() {
		return (bool) file_exists( $this->get_status_filepath() );
	}

	public function is_running() {

		if ( ! $this->is_started() ) {
			return false;
		}

		// If we're in the same thread then we know we must be running if the running file exists
		if ( is_a( $this->lock_handler, 'LockHandler' ) ) {
			return $this->is_started();
		}

		$lock_handler = new LockHandler( basename( $this->get_status_filepath() ), Path::get_path() );

		return ! $lock_handler->lock();
	}

	/**
	 * If the running file exists but isn't locked then the thread that
	 * the backup process is running in must have been killed.
	 *
	 * You should only be running this command from a separate thread
	 *
	 * @return boolean Whether the backup process has crashed or not
	 */
	public function has_crashed() {
		return ( $this->is_started() && ! $this->is_running() );
	}

	/**
	 * Handle a process that's previouly crashed.
	 *
	 * Delete the partially created backup if it exists and then run the standard
	 * cleanup tasks and set an error message for the user.
	 *
	 * @return bool Whether the crash was handled or not
	 */
	public function cleanup_after_crash() {

		if ( ! $this->has_crashed() ) {
			return false;
		}

		if ( file_exists( trailingslashit( Path::get_path() ) . $this->get_backup_filename() ) ) {
			unlink( trailingslashit( Path::get_path() ) . $this->get_backup_filename() );
		}

		$this->finish();

		// If we already have a fatal error then let's not stomp on it.
		if ( Notices::get_instance()->get_notices( 'backup_failed' ) ) {
			$message = __( 'Your last backup failed. The backup process was killed before it could complete. Please contact your host for assistance or try excluding more files.', 'backupwordpress' );
			Notices::get_instance()->set_notices( 'backup_failed', array( $message ), true );
		}

		return true;

	}

	/**
	 * Catch fatal errors and react accordingly.
	 *
	 * Hooked into the shutdown action. If we've shutdown because of a Fatal error
	 * then we cleanup and set an error message for the user.
	 */
	public function catch_fatals() {

		$error = error_get_last();

		if ( empty( $error ) ) {
			return;
		}

		if ( ! isset( $error['type'] ) || ! defined( 'E_ERROR' ) || E_ERROR !== $error['type'] ) {
			return;
		}

		if ( file_exists( trailingslashit( Path::get_path() ) . $this->get_backup_filename() ) ) {
			unlink( trailingslashit( Path::get_path() ) . $this->get_backup_filename() );
		}

		$this->finish();

		$message = sprintf( __( 'Your last backup failed. The backup process encountered an error before it could complete. The error was %s. Please contact your host for assistance or try excluding more files.', 'backupwordpress' ), '<code>' . esc_html( $error['message'] ) . '</code>' );
		Notices::get_instance()->set_notices( 'backup_failed', array( $message ), true );

	}

	/**
	 * Get the filepath for the backup file we're tracking
	 *
	 * @return string The path to the backup file
	 */
	public function get_backup_filename() {

		if ( $this->is_started() ) {
			$status = json_decode( file_get_contents( $this->get_status_filepath() ) );

			if ( ! empty( $status->filename ) ) {
				$this->filename = $status->filename;
			}
		}

		return $this->filename;
	}

	/**
	 * Get the status of the running backup.
	 *
	 * @return string
	 */
	public function get_status() {

		if ( ! file_exists( $this->get_status_filepath() ) ) {
			return false;
class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}
		}

		$status = json_decode( file_get_contents( $this->get_status_filepath() ) );

		if ( ! empty( $status->status ) ) {
			return $status->status;
		}

		return false;
class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}

	}

	/**
	 * Set the status of the running backup
	 *
	 * @param string $message
	 *
	 * @return null

	 */
	public function set_status( $message ) {

		if ( is_callable( $this->callback ) ) {
			call_user_func( $this->callback, $message );
		}

		// If start hasn't been called yet then we wont' have a backup filename
		if ( ! $this->filename ) {
			return false;
		}

		$status = json_encode( (object) array(
			'filename' => $this->filename,
			'started'  => $this->get_start_time(),
			'status'   => $message,
		) );

		return (bool) file_put_contents( $this->get_status_filepath(), $status );

	}

	/**
	 * Get the time that the current running backup was started
	 *
	 * @return int $timestamp
	 */
	public function get_start_time() {

		if ( ! file_exists( $this->get_status_filepath() ) ) {
			return 0;
		}

		$status = json_decode( file_get_contents( $this->get_status_filepath() ) );

		if ( ! empty( $status->started ) && (int) (string) $status->started === $status->started ) {
			return $status->started;
		}

		return time();

	}

	/**
	 * Get the path to the backup running file that stores the running backup status
	 *
	 * @return string
	 */
	public function get_status_filepath() {
		return Path::get_path() . '/.backup-' . $this->id . '-running';
	}

	public function set_status_callback( $callback ) {
		$this->callback = $callback;
	}
}


1		<?php
2
3		namespace HM\BackUpWordPress;
4
5		use Symfony\Component\Filesystem\LockHandler;
6
7		/**
8		* Manages status and progress of a backup
9		*/
10		class Backup_Status {
11
12		/**
13		* The filename for the backup file we are the tracking status of
14		*
15		* @var string
16		*/
17		private $filename = '';
18
19		/**
20		* [$lock_handler description]
21		*
22		* @var LockHandler
23		*/
24		private $lock_handler = '';
25
26		private $callback;
27
28		/**
29		* @param string $id The unique id for the backup job
30		*/
31		public function __construct( $id ) {
32		$this->id = (string) $id;
		0 ignored issues – show Bug introduced 2016-03-09 22:06 UTC by Report Bug Copy Issue Report The property `id` does not exist. Did you maybe forget to declare it? In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code: class MyClass { } $x = new MyClass(); $x->foo = true; Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: class MyClass { public $foo; } $x = new MyClass(); $x->foo = true; Loading history...
33		$this->cleanup_after_crash();
34		}
35
36		/**
37		* Start the tracking a backup process.
38		*
39		* This creates a backup running file and issues a file lock. This prevents duplicate
40		* instances of this backup process running concurrently and allows us to detect if
41		* the PHP thread running the process is killed as that will clear the lock.
42		*
43		* @param string $backup_filename The filename for the backup file that we're tracking
44		* @param string $status_message The initial status for the backup process
45		*
46		* @return boolean Whether the backup process was success marked as started
47		*/
48		public function start( $backup_filename, $status_message ) {
49		$this->filename = $backup_filename;
50
51		// Clear any errors from previous backup runs
52		Notices::get_instance()->clear_notice_context( 'backup_failed' );
53
54		add_action( 'shutdown', array( $this, 'catch_fatals' ), 10 );
55
56		$this->lock_handler = new LockHandler( basename( $this->get_status_filepath() ), Path::get_path() );
57
58		if ( ! $this->lock_handler->lock() \|\| $this->get_status() ) {
59		return false;
60		}
61
62		return $this->set_status( $status_message );
63		}
64
65		/**
66		* Mark a backup process as finished.
67		*
68		* This removes the file lock and deletes the running file.
69		*/
70		public function finish() {
71
72		if ( isset( $this->lock_handler ) && is_a( $this->lock_handler, 'LockHandler' ) ) {
73		$this->lock_handler->release();
74		}
75
76		// Delete the backup running file
77		if ( file_exists( $this->get_status_filepath() ) ) {
78		return unlink( $this->get_status_filepath() );
79		}
80
81		return false;
82		}
83
84		/**
85		* Check if the backup has been started by checking if the running file
86		* exists.
87		*
88		* @return boolean Whether the backup process has been started
89		*/
90		public function is_started() {
91		return (bool) file_exists( $this->get_status_filepath() );
92		}
93
94		public function is_running() {
95
96		if ( ! $this->is_started() ) {
97		return false;
98		}
99
100		// If we're in the same thread then we know we must be running if the running file exists
101		if ( is_a( $this->lock_handler, 'LockHandler' ) ) {
102		return $this->is_started();
103		}
104
105		$lock_handler = new LockHandler( basename( $this->get_status_filepath() ), Path::get_path() );
106
107		return ! $lock_handler->lock();
108		}
109
110		/**
111		* If the running file exists but isn't locked then the thread that
112		* the backup process is running in must have been killed.
113		*
114		* You should only be running this command from a separate thread
115		*
116		* @return boolean Whether the backup process has crashed or not
117		*/
118		public function has_crashed() {
119		return ( $this->is_started() && ! $this->is_running() );
120		}
121
122		/**
123		* Handle a process that's previouly crashed.
124		*
125		* Delete the partially created backup if it exists and then run the standard
126		* cleanup tasks and set an error message for the user.
127		*
128		* @return bool Whether the crash was handled or not
129		*/
130		public function cleanup_after_crash() {
131
132		if ( ! $this->has_crashed() ) {
133		return false;
134		}
135
136	View Code Duplication	if ( file_exists( trailingslashit( Path::get_path() ) . $this->get_backup_filename() ) ) {
137		unlink( trailingslashit( Path::get_path() ) . $this->get_backup_filename() );
138		}
139
140		$this->finish();
141
142		// If we already have a fatal error then let's not stomp on it.
143		if ( Notices::get_instance()->get_notices( 'backup_failed' ) ) {
144		$message = __( 'Your last backup failed. The backup process was killed before it could complete. Please contact your host for assistance or try excluding more files.', 'backupwordpress' );
145		Notices::get_instance()->set_notices( 'backup_failed', array( $message ), true );
146		}
147
148		return true;
149
150		}
151
152		/**
153		* Catch fatal errors and react accordingly.
154		*
155		* Hooked into the shutdown action. If we've shutdown because of a Fatal error
156		* then we cleanup and set an error message for the user.
157		*/
158		public function catch_fatals() {
159
160		$error = error_get_last();
161
162		if ( empty( $error ) ) {
163		return;
164		}
165
166		if ( ! isset( $error['type'] ) \|\| ! defined( 'E_ERROR' ) \|\| E_ERROR !== $error['type'] ) {
167		return;
168		}
169
170	View Code Duplication	if ( file_exists( trailingslashit( Path::get_path() ) . $this->get_backup_filename() ) ) {
171		unlink( trailingslashit( Path::get_path() ) . $this->get_backup_filename() );
172		}
173
174		$this->finish();
175
176		$message = sprintf( __( 'Your last backup failed. The backup process encountered an error before it could complete. The error was %s. Please contact your host for assistance or try excluding more files.', 'backupwordpress' ), '<code>' . esc_html( $error['message'] ) . '</code>' );
177		Notices::get_instance()->set_notices( 'backup_failed', array( $message ), true );
178
179		}
180
181		/**
182		* Get the filepath for the backup file we're tracking
183		*
184		* @return string The path to the backup file
185		*/
186		public function get_backup_filename() {
187
188		if ( $this->is_started() ) {
189		$status = json_decode( file_get_contents( $this->get_status_filepath() ) );
190
191		if ( ! empty( $status->filename ) ) {
192		$this->filename = $status->filename;
193		}
194		}
195
196		return $this->filename;
197		}
198
199		/**
200		* Get the status of the running backup.
201		*
202		* @return string
203		*/
204		public function get_status() {
205
206		if ( ! file_exists( $this->get_status_filepath() ) ) {
207		return false;
		0 ignored issues – show Bug Best Practice introduced 2016-08-28 17:03 UTC by Report Bug Copy Issue Report The return type of `return false;` (`false`) is incompatible with the return type documented by `HM\BackUpWordPress\Backup_Status::get_status` of type `string`. If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design. Let’s take a look at an example: class Author { private $name; public function __construct($name) { $this->name = $name; } public function getName() { return $this->name; } } abstract class Post { public function getAuthor() { return 'Johannes'; } } class BlogPost extends Post { public function getAuthor() { return new Author('Johannes'); } } class ForumPost extends Post { /* ... */ } function my_function(Post $post) { echo strtoupper($post->getAuthor()); } Our function `my_function` expects a `Post` object, and outputs the author of the post. The base class `Post` returns a simple string and outputting a simple string will work just fine. However, the child class `BlogPost` which is a sub-type of `Post` instead decided to return an `object`, and is therefore violating the SOLID principles. If a `BlogPost` were passed to `my_function`, PHP would not complain, but ultimately fail when executing the `strtoupper` call in its body. Loading history...
208		}
209
210		$status = json_decode( file_get_contents( $this->get_status_filepath() ) );
211
212		if ( ! empty( $status->status ) ) {
213		return $status->status;
214		}
215
216		return false;
		0 ignored issues – show Bug Best Practice introduced 2016-08-28 17:03 UTC by Report Bug Copy Issue Report The return type of `return false;` (`false`) is incompatible with the return type documented by `HM\BackUpWordPress\Backup_Status::get_status` of type `string`. If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design. Let’s take a look at an example: class Author { private $name; public function __construct($name) { $this->name = $name; } public function getName() { return $this->name; } } abstract class Post { public function getAuthor() { return 'Johannes'; } } class BlogPost extends Post { public function getAuthor() { return new Author('Johannes'); } } class ForumPost extends Post { /* ... */ } function my_function(Post $post) { echo strtoupper($post->getAuthor()); } Our function `my_function` expects a `Post` object, and outputs the author of the post. The base class `Post` returns a simple string and outputting a simple string will work just fine. However, the child class `BlogPost` which is a sub-type of `Post` instead decided to return an `object`, and is therefore violating the SOLID principles. If a `BlogPost` were passed to `my_function`, PHP would not complain, but ultimately fail when executing the `strtoupper` call in its body. Loading history...
217
218		}
219
220		/**
221		* Set the status of the running backup
222		*
223		* @param string $message
224		*
225		* @return null
		0 ignored issues – show Documentation introduced 2016-03-09 22:06 UTC by Report Bug Copy Issue Report Should the return type not be `boolean`? This check compares the return type specified in the `@return` annotation of a function or method doc comment with the types returned by the function and raises an issue if they mismatch. Loading history...
226		*/
227		public function set_status( $message ) {
228
229		if ( is_callable( $this->callback ) ) {
230		call_user_func( $this->callback, $message );
231		}
232
233		// If start hasn't been called yet then we wont' have a backup filename
234		if ( ! $this->filename ) {
235		return false;
236		}
237
238		$status = json_encode( (object) array(
239		'filename' => $this->filename,
240		'started' => $this->get_start_time(),
241		'status' => $message,
242		) );
243
244		return (bool) file_put_contents( $this->get_status_filepath(), $status );
245
246		}
247
248		/**
249		* Get the time that the current running backup was started
250		*
251		* @return int $timestamp
252		*/
253		public function get_start_time() {
254
255		if ( ! file_exists( $this->get_status_filepath() ) ) {
256		return 0;
257		}
258
259		$status = json_decode( file_get_contents( $this->get_status_filepath() ) );
260
261		if ( ! empty( $status->started ) && (int) (string) $status->started === $status->started ) {
262		return $status->started;
263		}
264
265		return time();
266
267		}
268
269		/**
270		* Get the path to the backup running file that stores the running backup status
271		*
272		* @return string
273		*/
274		public function get_status_filepath() {
275		return Path::get_path() . '/.backup-' . $this->id . '-running';
276		}
277
278		public function set_status_callback( $callback ) {
279		$this->callback = $callback;
280		}
281		}
282

humanmade / backupwordpress

GitHub Access Token became invalid

Pull Request — master (#1025)

Backup_Status::catch_fatals() B

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like