1
|
|
|
<?php |
2
|
|
|
/* HEADER */ // phpcs:ignore |
3
|
|
|
|
4
|
|
|
/** |
5
|
|
|
* This class selects the most recent version of a registered path. |
6
|
|
|
*/ |
7
|
|
|
class Manifest_Handler { |
8
|
|
|
|
9
|
|
|
/** |
10
|
|
|
* An array of the active plugin paths we want to search. |
11
|
|
|
* |
12
|
|
|
* @var array |
13
|
|
|
*/ |
14
|
|
|
private $active_plugin_paths; |
15
|
|
|
|
16
|
|
|
/** |
17
|
|
|
* The Version_Selector object. |
18
|
|
|
* |
19
|
|
|
* @var Version_Selector |
20
|
|
|
*/ |
21
|
|
|
private $version_selector; |
22
|
|
|
|
23
|
|
|
/** |
24
|
|
|
* The constructor. |
25
|
|
|
* |
26
|
|
|
* @param array $active_plugin_paths An array of the active plugin paths we want to search. |
27
|
|
|
* @param Version_Selector $version_selector The Version_Selector object. |
28
|
|
|
*/ |
29
|
|
|
public function __construct( $active_plugin_paths, $version_selector ) { |
30
|
|
|
$this->active_plugin_paths = $active_plugin_paths; |
31
|
|
|
$this->version_selector = $version_selector; |
32
|
|
|
} |
33
|
|
|
|
34
|
|
|
/** |
35
|
|
|
* Registers all of the paths in a given manifest. |
36
|
|
|
* |
37
|
|
|
* @param string $manifest_path The path that we're loading the manifest from in each plugin. |
38
|
|
|
* @param array $path_map The path map to add the contents of the manifests to. |
39
|
|
|
* |
40
|
|
|
* @return array $path_map The path map we've built using the manifests in each plugin. |
41
|
|
|
*/ |
42
|
|
|
public function register_plugin_manifests( $manifest_path, &$path_map ) { |
43
|
|
|
$file_paths = array_map( |
44
|
|
|
function ( $path ) use ( $manifest_path ) { |
45
|
|
|
return trailingslashit( $path ) . $manifest_path; |
46
|
|
|
}, |
47
|
|
|
$this->active_plugin_paths |
48
|
|
|
); |
49
|
|
|
|
50
|
|
|
foreach ( $file_paths as $path ) { |
51
|
|
|
$this->register_manifest( $path, $path_map ); |
52
|
|
|
} |
53
|
|
|
|
54
|
|
|
return $path_map; |
55
|
|
|
} |
56
|
|
|
|
57
|
|
|
/** |
58
|
|
|
* Registers a plugin's manifest file with the path map. |
59
|
|
|
* |
60
|
|
|
* @param string $manifest_path The absolute path to the manifest that we're loading. |
61
|
|
|
* @param array $path_map The path map to add the contents of the manifest to. |
62
|
|
|
*/ |
63
|
|
|
protected function register_manifest( $manifest_path, &$path_map ) { |
64
|
|
|
if ( ! is_readable( $manifest_path ) ) { |
65
|
|
|
return; |
66
|
|
|
} |
67
|
|
|
|
68
|
|
|
$manifest = require $manifest_path; |
69
|
|
|
if ( ! is_array( $manifest ) ) { |
70
|
|
|
return; |
71
|
|
|
} |
72
|
|
|
|
73
|
|
|
foreach ( $manifest as $key => $data ) { |
74
|
|
|
$this->register_record( $key, $data, $path_map ); |
75
|
|
|
} |
76
|
|
|
} |
77
|
|
|
|
78
|
|
|
/** |
79
|
|
|
* Registers an entry from the manifest in the path map. |
80
|
|
|
* |
81
|
|
|
* @param string $key The identifier for the entry we're registering. |
82
|
|
|
* @param array $data The data for the entry we're registering. |
83
|
|
|
* @param array $path_map The path map to add the contents of the manifest to. |
84
|
|
|
*/ |
85
|
|
|
protected function register_record( $key, $data, &$path_map ) { |
86
|
|
|
if ( isset( $path_map[ $key ]['version'] ) ) { |
87
|
|
|
$selected_version = $path_map[ $key ]['version']; |
88
|
|
|
} else { |
89
|
|
|
$selected_version = null; |
90
|
|
|
} |
91
|
|
|
|
92
|
|
|
if ( $this->version_selector->is_version_update_required( $selected_version, $data['version'] ) ) { |
93
|
|
|
$path_map[ $key ] = array( |
94
|
|
|
'version' => $data['version'], |
95
|
|
|
'path' => $data['path'], |
96
|
|
|
); |
97
|
|
|
} |
98
|
|
|
} |
99
|
|
|
} |
100
|
|
|
|