Ở bài trước form viết bài của MiniBlog đã kiểm tra dữ liệu đầy đủ, nhưng bài viết vẫn mất khi server khởi động lại. Tiếp tục với series, bài này mình sẽ giới thiệu với mọi người cách kết nối MySQL trong Express: chạy MySQL 8.4 bằng Docker, connection pool của mysql2 và prepared statement chống SQL injection (cần biết SQL cơ bản, xem series Node.js & MySQL).
1. Chạy MySQL 8.4 bằng Docker.
Thay vì cài vào máy, mình chạy MySQL 8.4 (dòng LTS) trong container Docker:
docker run -d --name miniblog-mysql -p 127.0.0.1:3306:3306 \
-e MYSQL_ROOT_PASSWORD=rootsecret \
-e MYSQL_DATABASE=miniblog \
-e MYSQL_USER=miniblog \
-e MYSQL_PASSWORD=secret \
-v miniblog-mysql-data:/var/lib/mysql \
mysql:8.4
Trong đó:
-p 127.0.0.1:3306:3306: mở cổng 3306 chỉ cho máy mình (localhost), máy khác trong mạng không kết nối được tới MySQL đang dùng mật khẩu đơn giản này. Ứng dụng kết nối qualocalhost:3306.MYSQL_ROOT_PASSWORD: mật khẩuroot(bắt buộc).MYSQL_DATABASE,MYSQL_USER,MYSQL_PASSWORD: tạo sẵn database và tài khoảnminiblogcó toàn quyền trên database đó, ứng dụng sẽ dùng tài khoản này.-v: lưu dữ liệu vào volume, xoá container thì dữ liệu vẫn còn.
Lần đầu MySQL mất vài chục giây để khởi tạo. Những lần sau chỉ cần docker start miniblog-mysql (tắt bằng docker stop).
2. Tạo bảng cho MiniBlog.
MiniBlog cần ba bảng: users (tác giả), posts (bài viết) và comments (bình luận):
-- Gửi dữ liệu dạng utf8mb4 để lưu đúng tiếng Việt
SET NAMES utf8mb4;
-- Xoá bảng cũ (nếu có) để chạy lại file này là có dữ liệu ban đầu
DROP TABLE IF EXISTS comments, posts, users;
-- Tác giả, mật khẩu sẽ được băm ở Bài 16
CREATE TABLE users (
id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(100) NOT NULL,
email VARCHAR(255) NOT NULL UNIQUE,
password VARCHAR(255) NOT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
-- Bài viết, author_id để trống được cho đến khi có đăng nhập
CREATE TABLE posts (
id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
title VARCHAR(150) NOT NULL,
slug VARCHAR(200) NOT NULL UNIQUE,
content TEXT NOT NULL,
cover VARCHAR(255) NULL,
author_id INT UNSIGNED NULL,
published_at DATETIME NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
FOREIGN KEY (author_id) REFERENCES users (id) ON DELETE SET NULL
);
-- Bình luận, xoá bài viết thì xoá luôn bình luận của nó
CREATE TABLE comments (
id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
post_id INT UNSIGNED NOT NULL,
name VARCHAR(100) NOT NULL,
content TEXT NOT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (post_id) REFERENCES posts (id) ON DELETE CASCADE
);
-- Dữ liệu mẫu: hai bài viết đang có trong data/posts.js
INSERT INTO posts (title, slug, content, published_at) VALUES
('Những tính năng mới trong Express 5', 'nhung-tinh-nang-moi-trong-express-5', 'Giới thiệu Express 5...', NOW()),
('Route trong Express 5', 'route-trong-express-5', 'Route trong Express...', NOW());
slug có UNIQUE để không trùng địa chỉ, author_id cho phép NULL vì tới Bài 16 mới có đăng nhập. SET NAMES utf8mb4 giữ đúng tiếng Việt khi import.
Chạy file SQL bằng client mysql có sẵn trong container (Windows dùng Git Bash hoặc WSL), rồi kiểm tra. Client này mặc định dùng bảng mã latin1, nên mình thêm --default-character-set=utf8mb4; thiếu nó thì SELECT in tiếng Việt thành Nh?ng dù dữ liệu trong bảng vẫn đúng:
docker exec -i miniblog-mysql mysql --default-character-set=utf8mb4 \
-u miniblog -psecret miniblog < database/schema.sql
# mysql: [Warning] Using a password on the command line interface can be insecure.
docker exec miniblog-mysql mysql --default-character-set=utf8mb4 \
-u miniblog -psecret miniblog -e 'SHOW TABLES'
# mysql: [Warning] Using a password on the command line interface can be insecure.
# Tables_in_miniblog
# comments
# posts
# users
Cảnh báo kia ở local thì không sao. Muốn đưa dữ liệu về ban đầu, các bạn chạy lại lệnh import.
3. Kết nối bằng mysql2 và connection pool.
mysql2 là thư viện MySQL phổ biến cho Node.js, có sẵn API Promise (mysql2/promise) để dùng với async/await và hỗ trợ prepared statement. Cài vào MiniBlog (mình dùng bản 3.24.6):
npm install mysql2
Mở kết nối tới MySQL tốn thời gian. Connection pool giữ một nhóm kết nối cho các request dùng lại: cần truy vấn thì mượn một kết nối, xong thì trả về pool. Pool chỉ mở kết nối khi cần, tối đa connectionLimit, truy vấn vượt quá sẽ xếp hàng chờ.
Thông tin kết nối khác nhau giữa local và server nên đặt trong biến môi trường (Bài 2), thêm vào cả .env và .env.example:
- .env
PORT=3000
DB_HOST=localhost
DB_PORT=3306
DB_USER=miniblog
DB_PASSWORD=secret
DB_NAME=miniblog
Pool được tạo một lần trong file riêng, nơi nào cần thì import:
import mysql from 'mysql2/promise';
// Pool kết nối dùng chung cho cả ứng dụng, cấu hình lấy từ biến môi trường
const pool = mysql.createPool({
host: process.env.DB_HOST,
port: process.env.DB_PORT,
user: process.env.DB_USER,
password: process.env.DB_PASSWORD,
database: process.env.DB_NAME,
connectionLimit: 10,
});
export default pool;
port trống thì mặc định là 3306, connectionLimit mặc định đã là 10, mình ghi ra cho rõ.
Tạo pool chưa mở kết nối nào, sai mật khẩu hay MySQL chưa chạy thì tới truy vấn đầu tiên mới biết. Vì vậy server.js chạy thử SELECT 1 trước listen() (ESM cho phép await ngoài hàm):
import app from './app.js';
import pool from './lib/db.js';
const port = process.env.PORT || 3000;
// Kiểm tra kết nối MySQL trước khi nhận request, lỗi thì dừng chương trình
await pool.query('SELECT 1');
app.listen(port, (error) => {
if (error) {
throw error;
}
console.log(`MiniBlog đang chạy tại http://localhost:${port}`);
});
MySQL đang chạy thì npm run dev vẫn in MiniBlog đang chạy tại http://localhost:3000 như cũ. Thử docker stop miniblog-mysql rồi chạy lại, server dừng ngay với lỗi Error: connect ECONNREFUSED 127.0.0.1:3306. Sai mật khẩu thì lỗi là Access denied for user 'miniblog'@'...'. Thử xong nhớ bật lại MySQL.
4. Truy vấn với query() và execute().
Pool có hai method chạy SQL, đều trả về Promise của mảng [rows, fields]:
pool.query(sql, values): câu SQL thường, cóvaluesthì mysql2 escape rồi ghép vào câu SQL ở phía Node.js.pool.execute(sql, values): prepared statement, câu SQL chứa dấu?gửi lên MySQL trước, giá trị gửi riêng sau (statement được cache để dùng lại).
VD: Các bạn tạo file db-test.js trong thư mục miniblog để thử:
- db-test.js
import pool from './lib/db.js';
// Chỉ lấy rows, bỏ qua fields
const [rows] = await pool.query('SELECT id, title FROM posts');
console.log(rows);
// execute(): prepared statement, giá trị truyền riêng qua dấu ?
const [found] = await pool.execute('SELECT id, title FROM posts WHERE slug = ?', ['route-trong-express-5']);
console.log(found);
// Đóng pool để chương trình kết thúc
await pool.end();
node --env-file=.env db-test.js
# [
# { id: 1, title: 'Những tính năng mới trong Express 5' },
# { id: 2, title: 'Route trong Express 5' }
# ]
# [ { id: 2, title: 'Route trong Express 5' } ]
Không gọi pool.end() thì kết nối vẫn mở và chương trình không tự thoát. Trong Express thì pool sống suốt vòng đời server, handler là hàm async gọi await pool.execute(...), lỗi của MySQL tự đi tới error handler (Bài 7).
5. Prepared statement chống SQL injection.
SQL injection xảy ra khi giá trị người dùng gửi lên được nối thẳng vào câu SQL, làm thay đổi ý nghĩa câu lệnh. VD: Các bạn tạo thêm file injection.js:
- injection.js
import pool from './lib/db.js';
// Giả sử slug lấy từ URL, người dùng gõ gì cũng được
const slug = "abc' OR '1'='1";
// SAI: nối thẳng giá trị vào câu SQL
const [bad] = await pool.query(`SELECT id, title FROM posts WHERE slug = '${slug}'`);
console.log(bad.length);
// ĐÚNG: dùng dấu ? và truyền giá trị riêng
const [good] = await pool.execute('SELECT id, title FROM posts WHERE slug = ?', [slug]);
console.log(good.length);
await pool.end();
node --env-file=.env injection.js
# 2
# 0
Nối chuỗi làm câu lệnh thành WHERE slug = 'abc' OR '1'='1', luôn đúng nên lấy ra cả 2 bài. Với prepared statement, cả chuỗi chỉ là một giá trị và không có slug nào như vậy.
Nguyên tắc là mọi giá trị từ người dùng đều đi qua dấu ?. query(sql, values) cũng an toàn vì đã escape (giống module mysql), nhưng series này dùng execute() cho truy vấn có tham số.
Lưu ý: Dấu ? chỉ thay cho giá trị, không dùng cho tên bảng, tên cột. Truyền undefined thì execute() báo lỗi Bind parameters must not contain undefined, muốn lưu NULL thì truyền null.
Thử xong các bạn xoá hai file db-test.js và injection.js. Các route của MiniBlog vẫn đọc mảng trong data/posts.js.
Code đầy đủ của MiniBlog sau bài này nằm ở tag bai-12 trên GitHub; các thay đổi của riêng bài này: so sánh bai-11...bai-12.
6. Lời kết.
Như vậy là chúng ta đã tìm hiểu xong cách kết nối MySQL trong Express: chạy MySQL 8.4 bằng Docker, tạo bảng users, posts, comments, connection pool của mysql2 cấu hình qua biến môi trường, query(), execute() và prepared statement chống SQL injection. Bài sau mình sẽ giới thiệu với mọi người về CRUD với MySQL trong Express, thay mảng posts bằng các truy vấn thật để tạo, đọc, sửa và xoá bài viết.
Đăng ký nhận tin.
Chúng tôi chỉ gửi tối đa 2 lần trên 1 tháng. Tuyên bố không spam mail!





0 Comments