Readme update

Author: Visualq

CHANGELOG.md

@@ -1,7 +1,9 @@
 # Changelog
 
 All notable changes to this project will be documented in this file.
-
+## [0.3.0] - 2025-10-17
+- Added PIE / Packagist support (composer.json)
+- Added liboqs installation instructions
 
 ## [0.2.0] - 2025-10-03
 

README.md

@@ -50,7 +50,7 @@ Global namespace constants (e.g. `OQS\VERSION_TEXT`) mirror liboqs build info.
 use OQS\KEM;
 
 // Pick an algorithm supported by your liboqs build:
-$alg = defined('OQS\KEM::ALG_ML_KEM_768') ? OQS\KEM::ALG_ML_KEM_768 : OQS\KEM::ALG_KYBER768;
+$alg = defined('OQS\\KEM::ALG_ML_KEM_768') ? OQS\KEM::ALG_ML_KEM_768 : OQS\KEM::ALG_KYBER768;
 
 [$pk, $sk] = KEM::keypair($alg);
 [$ct, $ss1] = KEM::encapsulate($alg, $pk);
@@ -64,6 +64,32 @@ echo base64_encode($ct), "\n", base64_encode($ss1), "\n";
 
 ---
 
+## Installing liboqs
+
+Before building this PHP extension, you need the **liboqs** C library and headers installed on your system.  
+You can either build it from source or install it via a package manager if available.
+
+### Build from source (recommended)
+```bash
+git clone https://github.com/open-quantum-safe/liboqs.git
+cd liboqs
+mkdir build && cd build
+cmake -DCMAKE_INSTALL_PREFIX=/usr/local -DOQS_BUILD_ONLY_LIB=ON ..
+make -j$(nproc)
+sudo make install
+```
+This installs `liboqs.so` to `/usr/local/lib` and headers to `/usr/local/include/oqs`.
+
+### Verify installation
+```bash
+pkg-config --modversion liboqs
+# should report 0.14.0 or newer
+```
+
+Then proceed with the build steps below.
+
+---
+
 ## Requirements
 
 - PHP dev tools (`phpize`, `php-config`, headers)
@@ -93,8 +119,6 @@ sudo phpenmod oqs
 php -m | grep oqs
 ```
 
-
-
 ### Using an explicit liboqs prefix
 
 If liboqs isn’t in pkg-config, pass the prefix that contains `include/oqs` and `lib/`:
@@ -145,4 +169,4 @@ This extension is provided **as-is** without any warranty. It is intended for ex
 prototyping, and research purposes only. Do **not** use this software in production environments
 that require certified or audited cryptographic implementations. The liboqs library itself is
 not a FIPS-validated module, and the PHP wrapper has not been security reviewed. Use entirely
-at your own risk.
+at your own risk.