Add method parameter type documentation
[lhc/web/wiklou.git] / tests / phpunit / includes / api / ApiEditPageTest.php
1 <?php
2
3 /**
4 * Tests for MediaWiki api.php?action=edit.
5 *
6 * @author Daniel Kinzler
7 *
8 * @group API
9 * @group Database
10 * @group medium
11 */
12 class ApiEditPageTest extends ApiTestCase {
13
14 public function setUp() {
15 global $wgExtraNamespaces, $wgNamespaceContentModels, $wgContentHandlers, $wgContLang;
16
17 parent::setUp();
18
19 $wgExtraNamespaces[12312] = 'Dummy';
20 $wgExtraNamespaces[12313] = 'Dummy_talk';
21
22 $wgNamespaceContentModels[12312] = "testing";
23 $wgContentHandlers["testing"] = 'DummyContentHandlerForTesting';
24
25 MWNamespace::getCanonicalNamespaces( true ); # reset namespace cache
26 $wgContLang->resetNamespaces(); # reset namespace cache
27
28 $this->doLogin();
29 }
30
31 public function tearDown() {
32 global $wgExtraNamespaces, $wgNamespaceContentModels, $wgContentHandlers, $wgContLang;
33
34 unset( $wgExtraNamespaces[12312] );
35 unset( $wgExtraNamespaces[12313] );
36
37 unset( $wgNamespaceContentModels[12312] );
38 unset( $wgContentHandlers["testing"] );
39
40 MWNamespace::getCanonicalNamespaces( true ); # reset namespace cache
41 $wgContLang->resetNamespaces(); # reset namespace cache
42
43 parent::tearDown();
44 }
45
46 function testEdit() {
47 $name = 'Help:ApiEditPageTest_testEdit'; // assume Help namespace to default to wikitext
48
49 // -- test new page --------------------------------------------
50 $apiResult = $this->doApiRequestWithToken( array(
51 'action' => 'edit',
52 'title' => $name,
53 'text' => 'some text',
54 ) );
55 $apiResult = $apiResult[0];
56
57 // Validate API result data
58 $this->assertArrayHasKey( 'edit', $apiResult );
59 $this->assertArrayHasKey( 'result', $apiResult['edit'] );
60 $this->assertEquals( 'Success', $apiResult['edit']['result'] );
61
62 $this->assertArrayHasKey( 'new', $apiResult['edit'] );
63 $this->assertArrayNotHasKey( 'nochange', $apiResult['edit'] );
64
65 $this->assertArrayHasKey( 'pageid', $apiResult['edit'] );
66
67 // -- test existing page, no change ----------------------------
68 $data = $this->doApiRequestWithToken( array(
69 'action' => 'edit',
70 'title' => $name,
71 'text' => 'some text',
72 ) );
73
74 $this->assertEquals( 'Success', $data[0]['edit']['result'] );
75
76 $this->assertArrayNotHasKey( 'new', $data[0]['edit'] );
77 $this->assertArrayHasKey( 'nochange', $data[0]['edit'] );
78
79 // -- test existing page, with change --------------------------
80 $data = $this->doApiRequestWithToken( array(
81 'action' => 'edit',
82 'title' => $name,
83 'text' => 'different text'
84 ) );
85
86 $this->assertEquals( 'Success', $data[0]['edit']['result'] );
87
88 $this->assertArrayNotHasKey( 'new', $data[0]['edit'] );
89 $this->assertArrayNotHasKey( 'nochange', $data[0]['edit'] );
90
91 $this->assertArrayHasKey( 'oldrevid', $data[0]['edit'] );
92 $this->assertArrayHasKey( 'newrevid', $data[0]['edit'] );
93 $this->assertNotEquals(
94 $data[0]['edit']['newrevid'],
95 $data[0]['edit']['oldrevid'],
96 "revision id should change after edit"
97 );
98 }
99
100 function testNonTextEdit() {
101 $name = 'Dummy:ApiEditPageTest_testNonTextEdit';
102 $data = serialize( 'some bla bla text' );
103
104 // -- test new page --------------------------------------------
105 $apiResult = $this->doApiRequestWithToken( array(
106 'action' => 'edit',
107 'title' => $name,
108 'text' => $data, ) );
109 $apiResult = $apiResult[0];
110
111 // Validate API result data
112 $this->assertArrayHasKey( 'edit', $apiResult );
113 $this->assertArrayHasKey( 'result', $apiResult['edit'] );
114 $this->assertEquals( 'Success', $apiResult['edit']['result'] );
115
116 $this->assertArrayHasKey( 'new', $apiResult['edit'] );
117 $this->assertArrayNotHasKey( 'nochange', $apiResult['edit'] );
118
119 $this->assertArrayHasKey( 'pageid', $apiResult['edit'] );
120
121 // validate resulting revision
122 $page = WikiPage::factory( Title::newFromText( $name ) );
123 $this->assertEquals( "testing", $page->getContentModel() );
124 $this->assertEquals( $data, $page->getContent()->serialize() );
125 }
126
127 public static function provideEditAppend() {
128 return array(
129 array( #0: append
130 'foo', 'append', 'bar', "foobar"
131 ),
132 array( #1: prepend
133 'foo', 'prepend', 'bar', "barfoo"
134 ),
135 array( #2: append to empty page
136 '', 'append', 'foo', "foo"
137 ),
138 array( #3: prepend to empty page
139 '', 'prepend', 'foo', "foo"
140 ),
141 array( #4: append to non-existing page
142 null, 'append', 'foo', "foo"
143 ),
144 array( #5: prepend to non-existing page
145 null, 'prepend', 'foo', "foo"
146 ),
147 );
148 }
149
150 /**
151 * @dataProvider provideEditAppend
152 */
153 function testEditAppend( $text, $op, $append, $expected ) {
154 static $count = 0;
155 $count++;
156
157 // assume NS_HELP defaults to wikitext
158 $name = "Help:ApiEditPageTest_testEditAppend_$count";
159
160 // -- create page (or not) -----------------------------------------
161 if ( $text !== null ) {
162 if ( $text === '' ) {
163 // can't create an empty page, so create it with some content
164 $this->doApiRequestWithToken( array(
165 'action' => 'edit',
166 'title' => $name,
167 'text' => '(dummy)', ) );
168 }
169
170 list( $re ) = $this->doApiRequestWithToken( array(
171 'action' => 'edit',
172 'title' => $name,
173 'text' => $text, ) );
174
175 $this->assertEquals( 'Success', $re['edit']['result'] ); // sanity
176 }
177
178 // -- try append/prepend --------------------------------------------
179 list( $re ) = $this->doApiRequestWithToken( array(
180 'action' => 'edit',
181 'title' => $name,
182 $op . 'text' => $append, ) );
183
184 $this->assertEquals( 'Success', $re['edit']['result'] );
185
186 // -- validate -----------------------------------------------------
187 $page = new WikiPage( Title::newFromText( $name ) );
188 $content = $page->getContent();
189 $this->assertNotNull( $content, 'Page should have been created' );
190
191 $text = $content->getNativeData();
192
193 $this->assertEquals( $expected, $text );
194 }
195
196 function testEditSection() {
197 $this->markTestIncomplete( "not yet implemented" );
198 }
199
200 /**
201 * Test action=edit&section=new
202 * Run it twice so we test adding a new section on a
203 * page that doesn't exist (bug 52830) and one that
204 * does exist
205 */
206 function testEditNewSection() {
207 $name = 'Help:ApiEditPageTest_testEditNewSection';
208
209 // Test on a page that does not already exist
210 $this->assertFalse( Title::newFromText( $name )->exists() );
211 list( $re ) = $this->doApiRequestWithToken( array(
212 'action' => 'edit',
213 'title' => $name,
214 'section' => 'new',
215 'text' => 'test',
216 'summary' => 'header',
217 ));
218
219 $this->assertEquals( 'Success', $re['edit']['result'] );
220 // Check the page text is correct
221 $text = WikiPage::factory( Title::newFromText( $name ) )->getContent( Revision::RAW )->getNativeData();
222 $this->assertEquals( $text, "== header ==\n\ntest" );
223
224 // Now on one that does
225 $this->assertTrue( Title::newFromText( $name )->exists() );
226 list( $re2 ) = $this->doApiRequestWithToken( array(
227 'action' => 'edit',
228 'title' => $name,
229 'section' => 'new',
230 'text' => 'test',
231 'summary' => 'header',
232 ));
233
234 $this->assertEquals( 'Success', $re2['edit']['result'] );
235 $text = WikiPage::factory( Title::newFromText( $name ) )->getContent( Revision::RAW )->getNativeData();
236 $this->assertEquals( $text, "== header ==\n\ntest\n\n== header ==\n\ntest" );
237 }
238
239 function testUndo() {
240 $this->markTestIncomplete( "not yet implemented" );
241 }
242
243 function testEditConflict() {
244 static $count = 0;
245 $count++;
246
247 // assume NS_HELP defaults to wikitext
248 $name = "Help:ApiEditPageTest_testEditConflict_$count";
249 $title = Title::newFromText( $name );
250
251 $page = WikiPage::factory( $title );
252
253 // base edit
254 $page->doEditContent( new WikitextContent( "Foo" ),
255 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
256 $this->forceRevisionDate( $page, '20120101000000' );
257 $baseTime = $page->getRevision()->getTimestamp();
258
259 // conflicting edit
260 $page->doEditContent( new WikitextContent( "Foo bar" ),
261 "testing 2", EDIT_UPDATE, $page->getLatest(), self::$users['uploader']->user );
262 $this->forceRevisionDate( $page, '20120101020202' );
263
264 // try to save edit, expect conflict
265 try {
266 $this->doApiRequestWithToken( array(
267 'action' => 'edit',
268 'title' => $name,
269 'text' => 'nix bar!',
270 'basetimestamp' => $baseTime,
271 ), null, self::$users['sysop']->user );
272
273 $this->fail( 'edit conflict expected' );
274 } catch ( UsageException $ex ) {
275 $this->assertEquals( 'editconflict', $ex->getCodeString() );
276 }
277 }
278
279 function testEditConflict_redirect() {
280 static $count = 0;
281 $count++;
282
283 // assume NS_HELP defaults to wikitext
284 $name = "Help:ApiEditPageTest_testEditConflict_redirect_$count";
285 $title = Title::newFromText( $name );
286 $page = WikiPage::factory( $title );
287
288 $rname = "Help:ApiEditPageTest_testEditConflict_redirect_r$count";
289 $rtitle = Title::newFromText( $rname );
290 $rpage = WikiPage::factory( $rtitle );
291
292 // base edit for content
293 $page->doEditContent( new WikitextContent( "Foo" ),
294 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
295 $this->forceRevisionDate( $page, '20120101000000' );
296 $baseTime = $page->getRevision()->getTimestamp();
297
298 // base edit for redirect
299 $rpage->doEditContent( new WikitextContent( "#REDIRECT [[$name]]" ),
300 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
301 $this->forceRevisionDate( $rpage, '20120101000000' );
302
303 // conflicting edit to redirect
304 $rpage->doEditContent( new WikitextContent( "#REDIRECT [[$name]]\n\n[[Category:Test]]" ),
305 "testing 2", EDIT_UPDATE, $page->getLatest(), self::$users['uploader']->user );
306 $this->forceRevisionDate( $rpage, '20120101020202' );
307
308 // try to save edit; should work, because we follow the redirect
309 list( $re, , ) = $this->doApiRequestWithToken( array(
310 'action' => 'edit',
311 'title' => $rname,
312 'text' => 'nix bar!',
313 'basetimestamp' => $baseTime,
314 'redirect' => true,
315 ), null, self::$users['sysop']->user );
316
317 $this->assertEquals( 'Success', $re['edit']['result'],
318 "no edit conflict expected when following redirect" );
319
320 // try again, without following the redirect. Should fail.
321 try {
322 $this->doApiRequestWithToken( array(
323 'action' => 'edit',
324 'title' => $rname,
325 'text' => 'nix bar!',
326 'basetimestamp' => $baseTime,
327 ), null, self::$users['sysop']->user );
328
329 $this->fail( 'edit conflict expected' );
330 } catch ( UsageException $ex ) {
331 $this->assertEquals( 'editconflict', $ex->getCodeString() );
332 }
333 }
334
335 function testEditConflict_bug41990() {
336 static $count = 0;
337 $count++;
338
339 /*
340 * bug 41990: if the target page has a newer revision than the redirect, then editing the
341 * redirect while specifying 'redirect' and *not* specifying 'basetimestamp' erronously
342 * caused an edit conflict to be detected.
343 */
344
345 // assume NS_HELP defaults to wikitext
346 $name = "Help:ApiEditPageTest_testEditConflict_redirect_bug41990_$count";
347 $title = Title::newFromText( $name );
348 $page = WikiPage::factory( $title );
349
350 $rname = "Help:ApiEditPageTest_testEditConflict_redirect_bug41990_r$count";
351 $rtitle = Title::newFromText( $rname );
352 $rpage = WikiPage::factory( $rtitle );
353
354 // base edit for content
355 $page->doEditContent( new WikitextContent( "Foo" ),
356 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
357 $this->forceRevisionDate( $page, '20120101000000' );
358
359 // base edit for redirect
360 $rpage->doEditContent( new WikitextContent( "#REDIRECT [[$name]]" ),
361 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
362 $this->forceRevisionDate( $rpage, '20120101000000' );
363 $baseTime = $rpage->getRevision()->getTimestamp();
364
365 // new edit to content
366 $page->doEditContent( new WikitextContent( "Foo bar" ),
367 "testing 2", EDIT_UPDATE, $page->getLatest(), self::$users['uploader']->user );
368 $this->forceRevisionDate( $rpage, '20120101020202' );
369
370 // try to save edit; should work, following the redirect.
371 list( $re, , ) = $this->doApiRequestWithToken( array(
372 'action' => 'edit',
373 'title' => $rname,
374 'text' => 'nix bar!',
375 'redirect' => true,
376 ), null, self::$users['sysop']->user );
377
378 $this->assertEquals( 'Success', $re['edit']['result'],
379 "no edit conflict expected here" );
380 }
381
382 protected function forceRevisionDate( WikiPage $page, $timestamp ) {
383 $dbw = wfGetDB( DB_MASTER );
384
385 $dbw->update( 'revision',
386 array( 'rev_timestamp' => $dbw->timestamp( $timestamp ) ),
387 array( 'rev_id' => $page->getLatest() ) );
388
389 $page->clear();
390 }
391 }