These results are based on our legacy PHP analysis, consider migrating to our new PHP analysis engine instead. Learn more
1 | <?php |
||
2 | |||
3 | namespace Wikibase\Api\Service; |
||
4 | |||
5 | use Mediawiki\DataModel\EditInfo; |
||
6 | use Serializers\Serializer; |
||
7 | use UnexpectedValueException; |
||
8 | use Wikibase\Api\WikibaseApi; |
||
9 | use Wikibase\DataModel\Reference; |
||
10 | use Wikibase\DataModel\Statement\Statement; |
||
11 | use Wikibase\DataModel\Statement\StatementGuid; |
||
12 | |||
13 | /** |
||
14 | * @access private |
||
15 | * |
||
16 | * @author Addshore |
||
17 | */ |
||
18 | class ReferenceSetter { |
||
19 | |||
20 | /** |
||
21 | * @var WikibaseApi |
||
22 | */ |
||
23 | private $api; |
||
24 | |||
25 | /** |
||
26 | * @var Serializer |
||
27 | */ |
||
28 | private $referenceSerializer; |
||
29 | |||
30 | /** |
||
31 | * @param WikibaseApi $api |
||
32 | * @param Serializer $referenceSerializer |
||
33 | */ |
||
34 | public function __construct( WikibaseApi $api, Serializer $referenceSerializer ) { |
||
35 | $this->api = $api; |
||
36 | $this->referenceSerializer = $referenceSerializer; |
||
37 | } |
||
38 | |||
39 | /** |
||
40 | * @since 0.2 |
||
41 | * |
||
42 | * @param Reference $reference new reference value |
||
43 | * @param Statement|StatementGuid|string $statement Statement object or GUID which has the reference |
||
44 | * @param Reference|string $targetReference target (old) reference of hash |
||
45 | * @param EditInfo|null $editInfo |
||
46 | * |
||
47 | * @return bool |
||
48 | * @throws UnexpectedValueException |
||
49 | */ |
||
50 | public function set( Reference $reference, $statement, $targetReference = null, EditInfo $editInfo = null ) { |
||
51 | if( is_string( $statement ) ) { |
||
52 | $guid = $statement; |
||
53 | } else if ( $statement instanceof StatementGuid ) { |
||
54 | $guid = $statement->getSerialization(); |
||
0 ignored issues
–
show
|
|||
55 | } else if ( $statement instanceof Statement ) { |
||
56 | $guid = $statement->getGuid(); |
||
57 | } else { |
||
58 | throw new UnexpectedValueException( 'Could not get statement guid from $statement' ); |
||
59 | } |
||
60 | if( !is_string( $guid ) ) { |
||
61 | throw new UnexpectedValueException( 'Unexpected statement guid got from $statement' ); |
||
62 | } |
||
63 | |||
64 | $referenceSerialization = $this->referenceSerializer->serialize( $reference ); |
||
65 | |||
66 | $params = array( |
||
67 | 'statement' => $guid, |
||
68 | 'snaks' => json_encode( $referenceSerialization['snaks'] ), |
||
69 | 'snaks-order' => json_encode( $referenceSerialization['snaks-order'] ), |
||
70 | ); |
||
71 | |||
72 | if( !is_null( $targetReference ) ) { |
||
73 | if( $targetReference instanceof Reference ) { |
||
74 | $targetReference = $reference->getHash(); |
||
75 | } |
||
76 | if( !is_string( $targetReference ) ) { |
||
77 | throw new UnexpectedValueException( 'Could not get reference hash from $targetReference' ); |
||
78 | } |
||
79 | $params['reference'] = $targetReference; |
||
80 | } |
||
81 | |||
82 | $this->api->postRequest( 'wbsetreference', $params, $editInfo ); |
||
83 | return true; |
||
84 | } |
||
85 | |||
86 | } |
||
87 |
This method has been deprecated. The supplier of the class has supplied an explanatory message.
The explanatory message should give you some clue as to whether and when the method will be removed from the class and what other method or class to use instead.