Merge "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 /**
197 * Test action=edit&section=new
198 * Run it twice so we test adding a new section on a
199 * page that doesn't exist (bug 52830) and one that
200 * does exist
201 */
202 function testEditNewSection() {
203 $name = 'Help:ApiEditPageTest_testEditNewSection';
204
205 // Test on a page that does not already exist
206 $this->assertFalse( Title::newFromText( $name )->exists() );
207 list( $re ) = $this->doApiRequestWithToken( array(
208 'action' => 'edit',
209 'title' => $name,
210 'section' => 'new',
211 'text' => 'test',
212 'summary' => 'header',
213 ));
214
215 $this->assertEquals( 'Success', $re['edit']['result'] );
216 // Check the page text is correct
217 $text = WikiPage::factory( Title::newFromText( $name ) )->getContent( Revision::RAW )->getNativeData();
218 $this->assertEquals( $text, "== header ==\n\ntest" );
219
220 // Now on one that does
221 $this->assertTrue( Title::newFromText( $name )->exists() );
222 list( $re2 ) = $this->doApiRequestWithToken( array(
223 'action' => 'edit',
224 'title' => $name,
225 'section' => 'new',
226 'text' => 'test',
227 'summary' => 'header',
228 ));
229
230 $this->assertEquals( 'Success', $re2['edit']['result'] );
231 $text = WikiPage::factory( Title::newFromText( $name ) )->getContent( Revision::RAW )->getNativeData();
232 $this->assertEquals( $text, "== header ==\n\ntest\n\n== header ==\n\ntest" );
233 }
234
235 function testEditConflict() {
236 static $count = 0;
237 $count++;
238
239 // assume NS_HELP defaults to wikitext
240 $name = "Help:ApiEditPageTest_testEditConflict_$count";
241 $title = Title::newFromText( $name );
242
243 $page = WikiPage::factory( $title );
244
245 // base edit
246 $page->doEditContent( new WikitextContent( "Foo" ),
247 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
248 $this->forceRevisionDate( $page, '20120101000000' );
249 $baseTime = $page->getRevision()->getTimestamp();
250
251 // conflicting edit
252 $page->doEditContent( new WikitextContent( "Foo bar" ),
253 "testing 2", EDIT_UPDATE, $page->getLatest(), self::$users['uploader']->user );
254 $this->forceRevisionDate( $page, '20120101020202' );
255
256 // try to save edit, expect conflict
257 try {
258 $this->doApiRequestWithToken( array(
259 'action' => 'edit',
260 'title' => $name,
261 'text' => 'nix bar!',
262 'basetimestamp' => $baseTime,
263 ), null, self::$users['sysop']->user );
264
265 $this->fail( 'edit conflict expected' );
266 } catch ( UsageException $ex ) {
267 $this->assertEquals( 'editconflict', $ex->getCodeString() );
268 }
269 }
270
271 function testEditConflict_redirect() {
272 static $count = 0;
273 $count++;
274
275 // assume NS_HELP defaults to wikitext
276 $name = "Help:ApiEditPageTest_testEditConflict_redirect_$count";
277 $title = Title::newFromText( $name );
278 $page = WikiPage::factory( $title );
279
280 $rname = "Help:ApiEditPageTest_testEditConflict_redirect_r$count";
281 $rtitle = Title::newFromText( $rname );
282 $rpage = WikiPage::factory( $rtitle );
283
284 // base edit for content
285 $page->doEditContent( new WikitextContent( "Foo" ),
286 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
287 $this->forceRevisionDate( $page, '20120101000000' );
288 $baseTime = $page->getRevision()->getTimestamp();
289
290 // base edit for redirect
291 $rpage->doEditContent( new WikitextContent( "#REDIRECT [[$name]]" ),
292 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
293 $this->forceRevisionDate( $rpage, '20120101000000' );
294
295 // conflicting edit to redirect
296 $rpage->doEditContent( new WikitextContent( "#REDIRECT [[$name]]\n\n[[Category:Test]]" ),
297 "testing 2", EDIT_UPDATE, $page->getLatest(), self::$users['uploader']->user );
298 $this->forceRevisionDate( $rpage, '20120101020202' );
299
300 // try to save edit; should work, because we follow the redirect
301 list( $re, , ) = $this->doApiRequestWithToken( array(
302 'action' => 'edit',
303 'title' => $rname,
304 'text' => 'nix bar!',
305 'basetimestamp' => $baseTime,
306 'redirect' => true,
307 ), null, self::$users['sysop']->user );
308
309 $this->assertEquals( 'Success', $re['edit']['result'],
310 "no edit conflict expected when following redirect" );
311
312 // try again, without following the redirect. Should fail.
313 try {
314 $this->doApiRequestWithToken( array(
315 'action' => 'edit',
316 'title' => $rname,
317 'text' => 'nix bar!',
318 'basetimestamp' => $baseTime,
319 ), null, self::$users['sysop']->user );
320
321 $this->fail( 'edit conflict expected' );
322 } catch ( UsageException $ex ) {
323 $this->assertEquals( 'editconflict', $ex->getCodeString() );
324 }
325 }
326
327 function testEditConflict_bug41990() {
328 static $count = 0;
329 $count++;
330
331 /*
332 * bug 41990: if the target page has a newer revision than the redirect, then editing the
333 * redirect while specifying 'redirect' and *not* specifying 'basetimestamp' erronously
334 * caused an edit conflict to be detected.
335 */
336
337 // assume NS_HELP defaults to wikitext
338 $name = "Help:ApiEditPageTest_testEditConflict_redirect_bug41990_$count";
339 $title = Title::newFromText( $name );
340 $page = WikiPage::factory( $title );
341
342 $rname = "Help:ApiEditPageTest_testEditConflict_redirect_bug41990_r$count";
343 $rtitle = Title::newFromText( $rname );
344 $rpage = WikiPage::factory( $rtitle );
345
346 // base edit for content
347 $page->doEditContent( new WikitextContent( "Foo" ),
348 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
349 $this->forceRevisionDate( $page, '20120101000000' );
350
351 // base edit for redirect
352 $rpage->doEditContent( new WikitextContent( "#REDIRECT [[$name]]" ),
353 "testing 1", EDIT_NEW, false, self::$users['sysop']->user );
354 $this->forceRevisionDate( $rpage, '20120101000000' );
355 $baseTime = $rpage->getRevision()->getTimestamp();
356
357 // new edit to content
358 $page->doEditContent( new WikitextContent( "Foo bar" ),
359 "testing 2", EDIT_UPDATE, $page->getLatest(), self::$users['uploader']->user );
360 $this->forceRevisionDate( $rpage, '20120101020202' );
361
362 // try to save edit; should work, following the redirect.
363 list( $re, , ) = $this->doApiRequestWithToken( array(
364 'action' => 'edit',
365 'title' => $rname,
366 'text' => 'nix bar!',
367 'redirect' => true,
368 ), null, self::$users['sysop']->user );
369
370 $this->assertEquals( 'Success', $re['edit']['result'],
371 "no edit conflict expected here" );
372 }
373
374 protected function forceRevisionDate( WikiPage $page, $timestamp ) {
375 $dbw = wfGetDB( DB_MASTER );
376
377 $dbw->update( 'revision',
378 array( 'rev_timestamp' => $dbw->timestamp( $timestamp ) ),
379 array( 'rev_id' => $page->getLatest() ) );
380
381 $page->clear();
382 }
383 }