beutnagel/doctype-validator

Check for valid W3C compliant DOCTYPEs

0.1.2-alpha 2016-11-20 21:28 UTC

This package is not auto-updated.

Last update: 2024-05-07 20:47:43 UTC


README

#Doctype Validator Test to see if an HTML doctype is valid according to the W3C specifications.

See more at: https://beutnagel.github.io/Doctype-Validator/

Latest Stable Version Total Downloads Reference Status GitHub issues

GitHub

##Installation##

Install with Composer

$ composer require beutnagel/doctype-validator

For the current alpha release

{
	"require": {
        "beutnagel/doctype-validator": "^0.1.1@alpha"
    },
    "minimum-stability": "alpha"
}

##Basic Usage The Doctype_Validator can be used to check the validity of a doctype, find errors and match it with existing official doctypes.

  1. First create an instance of the validator:
$dtv = new Doctype_Validator();
  1. Assign the doctype you want to validate:
$doctype = "<!DOCTYPE html>";

Is it a valid doctype?

Checking to see if a doctype is valid.

$valid = $dtv->validate($doctype)->isValid();

@return boolean TRUE or FALSE.

Does it match an official doctype?

A check can be performed with isMatch() to see if there is a match.

$match = $dtv->validate($doctype)->isMatch();

@return boolean TRUE or FALSE

$matches = $dtv->validate($doctype)->matches();

@return string of name of match, or NULL if no match.

Errors

If a doctype is not valid, Doctype_Validator will try to analyse why it is not valid. A list of errors can be found in Doctype_Error.php.

A simple check if a doctype has errors in it can be performed by the hasError() function.

$error = $dtv->validate($doctype)->hasError();

@return boolean TRUE or FALSE.

You can retrieve errors with the getErrors() method.

$result  = $dtv->validate($doctype);
if($result->hasErrors())
{
  $errors = $result->getErrors();
}

@return array of errors.

Fragments

The doctype will be dissected into smaller fragments and these can be access with getFragments().

$fragments = $dtv->validate($doctype)->getFragments();

@return array of fragmentens

License

Doctype Validator is licensed under the MIT License - see the LICENSE file for details

Author

Jarne W. Beutnagel - jarne@beutnagel.dk - beutnagel.dk