1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
/* |
4
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
5
|
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
6
|
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
7
|
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
8
|
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
9
|
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
10
|
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
11
|
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
12
|
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
13
|
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
14
|
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
15
|
|
|
* |
16
|
|
|
* This software consists of voluntary contributions made by many individuals |
17
|
|
|
* and is licensed under the MIT license. For more information, see |
18
|
|
|
* <https://github.com/baleen/migrations>. |
19
|
|
|
*/ |
20
|
|
|
|
21
|
|
|
namespace Baleen\Migrations\Delta\Comparator; |
22
|
|
|
|
23
|
|
|
use Baleen\Migrations\Migration\Options\Direction; |
24
|
|
|
use Baleen\Migrations\Delta\DeltaInterface; |
25
|
|
|
|
26
|
|
|
/** |
27
|
|
|
* Compares two version with each other. |
28
|
|
|
* |
29
|
|
|
* @author Gabriel Somoza <[email protected]> |
30
|
|
|
*/ |
31
|
|
|
interface ComparatorInterface |
32
|
|
|
{ |
33
|
|
|
/** |
34
|
|
|
* MUST call static::compare() |
35
|
|
|
* |
36
|
|
|
* @param DeltaInterface $version1 |
37
|
|
|
* @param DeltaInterface $version2 |
38
|
|
|
* |
39
|
|
|
* @return int |
40
|
|
|
*/ |
41
|
|
|
public function __invoke(DeltaInterface $version1, DeltaInterface $version2); |
42
|
|
|
|
43
|
|
|
/** |
44
|
|
|
* Compares two versions with each other. The comparison function must return an integer less than, equal to, or |
45
|
|
|
* greater than zero if the first argument is considered to be respectively less than, equal to, or greater than the |
46
|
|
|
* second. |
47
|
|
|
* |
48
|
|
|
* @param DeltaInterface $version1 |
49
|
|
|
* @param DeltaInterface $version2 |
50
|
|
|
* |
51
|
|
|
* @return int |
52
|
|
|
*/ |
53
|
|
|
public function compare(DeltaInterface $version1, DeltaInterface $version2); |
54
|
|
|
|
55
|
|
|
/** |
56
|
|
|
* Returns a new comparator that sorts in the opposite direction. |
57
|
|
|
* |
58
|
|
|
* @return static |
59
|
|
|
*/ |
60
|
|
|
public function getReverse(); |
61
|
|
|
} |
62
|
|
|
|