README

A modern PHP package to extract structured data from resume PDFs — with both classic and OpenAI-powered AI parsing!

Easily extract names, emails, phone numbers, social handles, skills, education, experience, certifications, and languages from any resume PDF. Use classic parsing for speed, or unleash the power of OpenAI for even more robust results.

✨ Features

Extracts name, email, phone, address
Detects and normalizes global phone numbers
Extracts all major social handles (LinkedIn, GitHub, Twitter/X, Facebook, Instagram, Stack Overflow, Dribbble, Behance, Medium, YouTube, TikTok, Pinterest, Telegram, WhatsApp, blog, website)
Parses skills (technical, soft, and unique skills)
Extracts education, experience, certifications, and languages
Section-based parsing for high accuracy
Optional: AI-powered parsing using OpenAI for even more robust extraction
Outputs structured JSON/array

📦 Installation

composer require sohagsrz/resume-parser

⚡ Usage

Manual/Classic Parsing

require 'vendor/autoload.php';
use Sohagsrz\ResumeParser\ResumeParser;

$result = ResumeParser::parse('path/to/resume.pdf');
echo json_encode($result, JSON_PRETTY_PRINT);

AI-Powered Parsing (OpenAI)

require 'vendor/autoload.php';
use Sohagsrz\ResumeParser\OpenAIResumeParser;

$apiKey = 'sk-...'; // Your OpenAI API key
$result = OpenAIResumeParser::parse('path/to/resume.pdf', $apiKey);
echo json_encode($result, JSON_PRETTY_PRINT);

📝 Example Output Structure

{
  "name": "Md Sohag Islam",
  "email": "mdsohagislam25@gmail.com",
  "phone": "+8801798965122",
  "address": "Niyamotpur, Saidpur, Bangladesh",
  "linkedin": ["https://linkedin.com/in/sohagbd"],
  "github": ["https://github.com/sohag-dev"],
  "twitter": [],
  "facebook": [],
  "instagram": [],
  "stackoverflow": [],
  "dribbble": [],
  "behance": [],
  "medium": [],
  "youtube": [],
  "tiktok": [],
  "pinterest": [],
  "telegram": [],
  "whatsapp": [],
  "blog": [],
  "website": [],
  "skills": ["PHP", "Laravel", "React", "Tailwind CSS"],
  "education": [
    {
      "degree": "BSc in Computer Science",
      "institution": "AIUB",
      "year": "2026"
    }
  ],
  "experience": [
    {
      "job_title": "Backend Developer",
      "company": "Ujjol Lab",
      "duration": "2022-2024",
      "description": "Developed REST APIs, maintained Laravel applications."
    }
  ],
  "certifications": ["AWS Cloud Practitioner", "Meta Frontend Certificate"],
  "languages": ["English", "Bangla"]
}

💻 Example Demos

example/parse_example.php — Manual/classic parsing
example/bootstrap_upload.php — Manual/classic parsing with Bootstrap upload form
example/bootstrap_ai_upload.php — AI-powered parsing with Bootstrap upload form and OpenAI API key

🔑 OpenAI API Key

To use the AI-powered parser, you need an OpenAI API key. You can get one from OpenAI. Keep your API key secure and do not expose it publicly.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.

If you like this project, please ⭐ star it and follow me for more cool open-source tools!

📄 License

MIT

👤 Author

sohagsrz

sohagsrz / resume-parser

Maintainers

Details