French lawmakers have legalised same-sex marriage after months of bruising debate and street protests that brought hundreds of thousands to Paris.