Hướng dẫn nâng cấp DokuWiki lên bản mới nhất

Logo DokuWiki

Mình hiện đã dùng DokuWiki tới thời điểm viết bài này là 4 năm. Mục đích chính của việc dùng DokuWiki là mình cần một nơi để ghi lại các hướng dẫn, tài liệu sử dụng nội bộ mà không thể chia sẻ ra bên ngoài.

Nỗi kinh hoàng của giây phút ấy”, vị vua tiếp tục, “ta sẽ không bao giờ, không bao giờ quên!

Tuy vậy bệ hạ sẽ quên”, Nữ hoàng nói, “nếu bệ hạ không viết một bản ghi nhớ về nó. ”

Lewis Carroll

Việc có một nơi lưu trữ dữ liệu nội bộ là cực kỳ quan trọng để giảm tải việc phải hướng dẫn, giúp nhân sự hình thành thói quen ghi chép, từ đó nâng cap hiệu quả công việc. DokuWiki là một mã nguồn mở (open source) cực kỳ đỉnh và đơn giản nhưng vô cùng hiệu quả đó chính là lý do mình vẫn giữ DokuWiki và hôm nay sẽ viết hướng dẫn cách bạn update DokuWiki

Hướng dẫn này dành cho cách cài đặt thông thường, hướng dẫn chi tiết theo DokuWiki hướng dẫn bạn có thể xem tại đây

Lưu ý: Tại thời điểm viết bài này, bản mới nhất là Release 2020-07-29 “Hogfather”. Do đó nó cần phải chạy PHP 7.2 trở lên, tốt nhất bạn chọn 7.4 và sau có thể đưa lên Php8 vì Doku sẽ sớm được update lên Php 8.

Bước 1: Hãy backup lại dữ liệu trước khi bạn có bất kỳ dự định cập nhật nào.

Vì DokuWiki (mình viết tắt Doku) không có cần tới Mysql, do đó bạn chỉ cần nén toàn bộ thư mục Docs lại là xong.

Bước 2: Bạn tải bản mới nhất trên Doku về tại đây

Bước 3: Bạn tải cái file của bạn đã tải về, upload nó lên trên Hosting đè hết lên các file cũ của nó.

Bước 4: Bạn tiến hành xóa các file thừa trong code đi.

Doku sẽ tạo 1 danh sách các file cần xóa ở bản cũ (tức là các file thừa, chúng ta nên xóa nó đi, bởi lẽ nó không còn sử dụng). Cũng như nếu Doku có bug lỗi về bảo mật, các file đó gây ra lỗi bảo mật, vậy ta cũng cần xóa chúng đi luôn.

Có nhiều hướng dẫn, nhưng ở trong bày này mình sẽ hướng dẫn các bạn xóa bằng 1 file php đơn giản (https://www.dokuwiki.org/install:unused_files)

Bây giờ hãy tạo 1 file del.php (hoặc tên gì cũng được).

Nội dung sẽ như sau:

<?php
/* Security function, comment this out to "activate" the script. */
// exit('Check source');
 
$path = getcwd();
 
if(file_exists($path . '/data/deleted.files')) {
  $file = fopen($path . '/data/deleted.files', 'r');
  while(false !== ($line = fgets($file))) {
    $line = trim($line);
    if(!empty($line) && !preg_match('/^\#/', $line) && file_exists($path . '/' . $line)) {
      unlink($path . '/' . $line);
      echo '/' . $line . ' - deleted<br/>';
    }
  }
  echo 'Done!';
}

Sau đó bạn Upload file này lên thư mục gốc (thường trong public_html)

Bước 5: Chạy cái file del.php mà bạn vừa tạo

Bằng cách gõ: yourdomain.com/del.php

Sau khi bạn đã chạy xong, nếu nó hiển thị done như này là đã xong.

Xóa hết các file thừa của DokuWiki
Xóa hết các file thừa của DokuWiki

Sau khi đã update xong thì bạn sửa lại cái file del.php , bạn bỏ cái nút // ở đoạn

// exit('Check source');

Hoặc bạn xóa cái file này đi cũng đc, vì nó cũng là 1 file thừa.

Vậy là xong, hãy trải nghiệm bản mới nhất nhé.

Chúc bạn thành công !

Tú Cao
Tôi là Tú Cao. Tôi chia sẻ và dạy mọi người cách kinh doanh trên Internet. Bởi vì "Hạnh phúc không phải là nhận, hạnh phúc chính là sự cho đi". Bài viết này dựa trên quan điểm, hiểu biết của Tôi. Bạn tự cân nhắc và chịu trách nhiệm khi làm theo, nếu nó hữu ích với bạn hãy Mời Tú Cao một tách CÀ PHÊ.